Class ZArchive

source’ is null.

`档案(字符串,ZArchiveLoadOptions)`

启动一个新的例子的Aspose.Zip.Z.Archive类准备的压缩。

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

`Parameters`

path string

走到档案的源头。

loadOptions ZArchiveLoadOptions

与存档加载的选项。

`Remarks`

此构建器不解压. 查看 Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) 解压方法。

`Exceptions`

path’ is null.

召唤者没有所需的访问许可。

path’ 是空的,只包含白色空间,或包含无效的字符。

拒绝访问 path" 文件。

指定的 path’, 文件名, 或两者都超过系统定义的最大长度. 例如,在基于 Windows 的平台上,路径必须小于 248 个字符, 文件名必须小于 260 个字符。

DirectoryNotFoundException

文件在 path’ 中间包含一个列(:)。

FileNotFoundException

文件未找到。

指定的路径是无效的,例如在无地图驱动器上。

文件已经开放了。

`Methods`

`Dispose()`

执行与释放、释放或重新管理未管理资源相关的应用定义任务。

public void Dispose()

`Dispose(博尔)`

执行与释放、释放或重新管理未管理资源相关的应用定义任务。

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

管理的资源是否要消耗?

`Extract(Stream)`

将 Z 档案提取到一个流。

public void Extract(Stream destination)

`Parameters`

destination Stream

存储压缩数据的流量。

`Examples`

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
    {
        using (var archive = new ZArchive(zFile))
        {
            archive.Extract(extractedFile);
        }
    }
}

`Exceptions`

InvalidDataException

数据不能被压缩。

`Extract(FileInfo)`

将 Z 档案提取到一个文件中。

public void Extract(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

FileInfo 用于存储压缩数据。

`Examples`

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

`Exceptions`

呼叫者没有必要的许可,以打开 fileInfo。

文件路径是空的,或者只包含白色空间。

FileNotFoundException

文件未找到。

到文件的路径是阅读或是一个目录。

DirectoryNotFoundException

fileInfo’ is null.

指定的路径是无效的,例如在无地图驱动器上。

文件已经开放了。

InvalidDataException

数据不能被压缩。

`Extract(线条)`

通过路径将 Z 档案提取到一个文件。

public FileInfo Extract(string path)

`Parameters`

path string

路径到文件,将存储压缩数据。

`Returns`

FileInfo

提取的文件的信息。

`Examples`

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract("extracted.bin");
    }
}

`Exceptions`

path’ is null.

召唤者没有所需的访问许可。

path’ 是空的,只包含白色空间,或包含无效的字符。

拒绝访问 path" 文件。

指定的 path’, 文件名, 或两者都超过系统定义的最大长度. 例如,在基于 Windows 的平台上,路径必须小于 248 个字符, 文件名必须小于 260 个字符。

文件在 path’ 中间包含一个列(:)。

InvalidDataException

数据不能被压缩。

`ExtractToDirectory(线条)`

将档案内容提取到所提供的目录中。

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

路径到目录将提取的文件插入。

`Remarks`

如果目录不存在,它将被创建。

`Exceptions`

destinationDirectory’ is null.

例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260 个字符。

呼叫者没有必要的许可访问现有目录。

如果目录不存在,路径包含一个列符(:)不属于驱动标签(“C:”)的一部分。

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).

路径指定的目录是一个文件. -or- 网络名称不明。

`Save(流量,ZArchiveSaveOptions)`

xz 存储到提供的流。

public void Save(Stream output, ZArchiveSaveOptions settings = null)

`Parameters`

output Stream

目的地流

settings ZArchiveSaveOptions

可选设置档案组成。

`Examples`

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

`Remarks`

必须是可寻求的。

`Exceptions`

output’ does not support seeking.

output’ is null.

`Save(字符串, ZArchiveSaveOptions)`

将 Z 存储到所提供的目的地文件中。

public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)

`Parameters`

destinationFileName string

要创建的档案的路径如果指定的文件名指向现有文件,则将重写。

settings ZArchiveSaveOptions

可选设置档案组成。

`Examples`

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

`Exceptions`

destinationFileName’ is null.

召唤者没有所需的访问许可。

destinationFileName’ 是空的,只包含白色空间,或包含无效的字符。

拒绝访问 destinationFileName’ 文件。

指定的 destinationFileName’, 文件名, 或两者都超过系统定义的最大长度. 例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260 个字符。

文件在 destinationFileName’ 包含字符串中间的一个列(:)。

`SetSource(Stream)`

设置要压缩的内容在档案中。

public void SetSource(Stream source)

`Parameters`

source Stream

存档的输入流。

`Examples`

using (var archive = new ZArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.Z");
}

`SetSource(FileInfo)`

设置要压缩的内容在档案中。

public void SetSource(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

FileInfo 将作为输入流打开。

`Examples`

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

`Exceptions`

呼叫者没有必要的许可,以打开 fileInfo。

文件路径是空的,或者只包含白色空间。

FileNotFoundException

文件未找到。

到文件的路径是阅读或是一个目录。

DirectoryNotFoundException

fileInfo’ is null.

指定的路径是无效的,例如在无地图驱动器上。

文件已经开放了。

`SetSource(线条)`

设置要压缩的内容在档案中。

public void SetSource(string sourcePath)

`Parameters`

sourcePath string

到文件的路径,将作为输入流打开。

`Examples`

using (var archive = new ZArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("data.bin.Z");
}

`Exceptions`

sourcePath’ is null or empty string.

召唤者没有必要的许可访问资源。

sourcePath’ 是空的,只包含白色空间,或包含无效的字符。

拒绝访问 sourcePath’ 文件。

指定的 sourcePath’, 文件名, 或两者都超过系统定义的最大长度. 例如,在基于 Windows 的平台上,路径必须小于 248 个字符, 文件名必须小于 260 个字符。