Class Bzip2Archive

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

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

拒绝访问 path" 文件。

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

DirectoryNotFoundException

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

FileNotFoundException

文件未找到。

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

文件已经开放了。

EndOfStreamException

早流结束。

InvalidDataException

错误的签名比特

`Methods`

`Dispose()`

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

public void Dispose()

`Dispose(博尔)`

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

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

管理的资源是否要消耗?

`Extract(Stream)`

将文件提取到提供的流。

public void Extract(Stream destination)

`Parameters`

destination Stream

目的地流,必须写作。

`Examples`

using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
{
     archive.Extract(httpResponseStream);
}

`Exceptions`

destination’ does not support writing.

`Extract(线条)`

通过路径将文件提取到文件中。

public FileInfo Extract(string path)

`Parameters`

path string

路径到目的地文件. 如果文件已经存在,它将被过写。

`Returns`

FileInfo

获取的文件信息。

`Exceptions`

path’ is null.

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

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

拒绝访问 path" 文件。

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

DirectoryNotFoundException

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

FileNotFoundException

文件未找到。

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

文件已经开放了。

`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 (:).

InvalidOperationException

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

`Open()`

打开存档用于提取,并提供存档内容的流。

public Stream Open()

`Returns`

Stream

代表档案的内容的流。

`Examples`

使用:Stream decompressed = archive.Open();

.NET 4.0 或更高版本 - 使用 Stream.CopyTo 方法:decompressed.CopyTo(httpResponse.OutputStream)

.NET 3.5 和之前 - 手动复制比特:

byte[] buffer = new byte[8192];
int bytesRead;
while (0 &lt; (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
 fileStream.Write(buffer, 0, bytesRead);
```</p>

#### Remarks

Read from the stream to get the original content of the file. See examples section.

### <a id="Aspose_Zip_Bzip2_Bzip2Archive_Save_System_IO_Stream_Aspose_Zip_Bzip2_Bzip2SaveOptions_"></a> Save\(Stream, Bzip2SaveOptions\)

Saves archive to the stream provided.

```csharp
public void Save(Stream outputStream, Bzip2SaveOptions saveOptions = null)

`Parameters`

outputStream Stream

目的地流

saveOptions Bzip2SaveOptions

存储一个 bzip2 档案的选项. 如果没有指定,将使用 900 Kb 块大小。

`Examples`

将压缩数据写入 http 响应流。

using (var archive = new Bzip2Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

`Remarks`

必须是可写的。

`Exceptions`

要存档的数据来源尚未提供。

outputStream’ is not writable.

DirectoryNotFoundException

文件源仅是阅读或是目录。

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

文件源已经开放了。

`Save(字符串,Bzip2SaveOptions)`

存储存档到提供的目的地文件。

public void Save(string destinationFileName, Bzip2SaveOptions saveOptions = null)

`Parameters`

destinationFileName string

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

saveOptions Bzip2SaveOptions

存储一个 bzip2 档案的选项. 如果没有指定,将使用 900 Kb 块大小。

`Examples`

编写压缩数据到文件。

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

`Exceptions`

destinationFileName’ is null.

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

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

拒绝访问 destinationFileName’ 文件。

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

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

`SetSource(Stream)`

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

public void SetSource(Stream source)

`Parameters`

source Stream

存档的输入流。

`Examples`

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

`SetSource(FileInfo)`

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

public void SetSource(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

提到要压缩的文件。

`Examples`

using (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.bz2");
}

`SetSource(线条)`

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

public void SetSource(string path)

`Parameters`

path string

文件要压缩的路径。

`Examples`

using (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.bz2");
}

`Exceptions`

path’ is null.

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

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

拒绝访问 path" 文件。

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