TarArchive.Save
Contents
[
Hide
]Save(Stream, TarFormat?)
Saves archive to the stream provided.
public void Save(Stream output, TarFormat? format = default)
Parameter | Type | Description |
---|---|---|
output | Stream | Destination stream. |
format | Nullable`1 | Defines tar header format. Null value will be treated as USTar when possible. |
Exceptions
exception | condition |
---|---|
ArgumentException | output is not writable. - or - output is the same stream we extract from. - OR - It is impossible to save archive in format due to format restrictions. |
Remarks
output must be writable.
Examples
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(tarFile);
}
}
See Also
- enum TarFormat
- class TarArchive
- namespace Aspose.Zip.Tar
- assembly Aspose.Zip
Save(string, TarFormat?)
Saves archive to destination file provided.
public void Save(string destinationFileName, TarFormat? format = default)
Parameter | Type | Description |
---|---|---|
destinationFileName | String | The path of the archive to be created. If the specified file name points to an existing file, it will be overwritten. |
format | Nullable`1 | Defines tar header format. Null value will be treated as USTar when possible. |
Exceptions
exception | condition |
---|---|
ArgumentException | destinationFileName is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars. |
ArgumentNullException | destinationFileName is null. |
PathTooLongException | The specified destinationFileName, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. |
DirectoryNotFoundException | The specified destinationFileName is invalid, (for example, it is on an unmapped drive). |
IOException | An I/O error occurred while opening the file. |
UnauthorizedAccessException | destinationFileName specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission. |
NotSupportedException | destinationFileName is in an invalid format. |
FileNotFoundException | The file is not found. |
Remarks
It is possible to save an archive to the same path as it was loaded from. However, this is not recommended because this approach uses copying to temporary file.
Examples
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("myarchive.tar");
}
See Also
- enum TarFormat
- class TarArchive
- namespace Aspose.Zip.Tar
- assembly Aspose.Zip