Class Lz4Archive

sourceStream’ is null.

sourceStream’ is too short.

sourceStream’ 有错误的签名。

`Lz4Archive(线条)`

启动 Aspose.Zip.Lz4.Lz4档案类的新例子。

public Lz4Archive(string path)

`Parameters`

path string

走向档案的路径。

`Examples`

从文件中按路径打开一个档案,然后将其提取到一个

var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive("archive.lz4"))
  archive.Open().CopyTo(ms);

`Remarks`

此构建器不解压. 查看 Aspose.Zip.Lz4.Lz4Archive.Open 解压方法。

`Exceptions`

path’ is null.

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

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

拒绝访问 path" 文件。

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

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

文件太短了。

文件中的数据有错误的签名。

`Lz4Archive(Lz4ArchiveSetting)`

启动一个新的例子的 Aspose.Zip.Lz4. Lz4档案类准备压缩。

public Lz4Archive(Lz4ArchiveSetting settings = null)

`Parameters`

settings Lz4ArchiveSetting

组成档案的设置。

`Methods`

`Dispose()`

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

public void Dispose()

`Dispose(博尔)`

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

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

管理的资源是否要消耗?

`Extract(线条)`

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

public FileInfo Extract(string path)

`Parameters`

path string

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

`Returns`

FileInfo

提取的文件的信息。

`Exceptions`

源流太短了。

错误的比特在解码时被发现。

此 LZ4 版本不支持。

`Extract(Stream)`

将文件提取到提供的流。

public void Extract(Stream destination)

`Parameters`

destination Stream

目的地流,必须写作。

`Examples`

using (var archive = new Lz4Archive("archive.lz4"))
{
     archive.Extract(httpResponseStream);
}

`Exceptions`

destination’ does not support writing.

源流太短了。

错误的比特在解码时被发现。

此 LZ4 版本不支持。

档案编写为组成。

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

IOException

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

源流太短了。

发现错误的字节,同时启动解码。

档案编写为组成。

`Open()`

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

public Stream Open()

`Returns`

Stream

代表档案的内容的流。

`Examples`

提取档案并将提取的内容复制到文件流。

using (var archive = new Lz4Archive("archive.lz4"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 &lt; (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

您可以使用 .NET 4.0 或更高版本的 Stream.CopyTo 方法: unpacked.Kopy To(提取);

`Remarks`

从流中阅读,以获取文件的原始内容。

`Exceptions`

源流太短了。

发现错误的字节,同时启动解码。

档案编写为组成。

`Save(Stream)`

将 lz4 存储到提供的流。

public void Save(Stream output)

`Parameters`

output Stream

目的地流

`Examples`

using (FileStream lz4File = File.Open("archive.lz4", FileMode.Create))
{
    using (var archive = new Lz4Archive())
    {
        archive.SetSource("data.bin");
        archive.Save(lz4File);
     }
}

`Remarks`

必须是可寻求的。

`Exceptions`

output’ is null.

output’ is not writable.

存档已准备好提取 - 或 - Source 未提供。

`Save(FileInfo)`

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

public void Save(FileInfo destination)

`Parameters`

destination FileInfo

FileInfo,将作为目的地流开放。

`Examples`

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

`Exceptions`

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

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

FileNotFoundException

文件未找到。

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

DirectoryNotFoundException

destination’ is null.

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

IOException

文件已经开放了。

档案已准备好提取。

`Save(线条)`

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

public void Save(string destinationFileName)

`Parameters`

destinationFileName string

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

`Examples`

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

`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 Lz4Archive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.lz4");
}

`Exceptions`

档案已准备好提取。

`SetSource(FileInfo)`

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

public void SetSource(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

提到要压缩的文件。

`Examples`

从一个流中打开一个档案,然后将其提取到一个

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

`Exceptions`

档案已准备好提取。

`SetSource(圖片來源:TarFormat)`

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

public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)

`Parameters`

tarArchive TarArchive

要压缩的档案。

format TarFormat

定义 Tar Header 格式。

`Examples`

using (var tarArchive = new TarArchive())
{
    tarArchive.CreateEntry("first.bin", "data1.bin");
    tarArchive.CreateEntry("second.bin", "data2.bin");
    using (var lz4Archive = new Lz4Archive())
    {
        lz4Archive.SetSource(tarArchive);
        lz4Archive.Save("archive.tar.lz4");
    }
}

`Remarks`

使用此方法编写合并 tar.lz4 档案。

`SetSource(线条)`

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

public void SetSource(string path)

`Parameters`

path string

文件要压缩的路径。

`Examples`

从文件中按路径打开一个档案,然后将其提取到一个

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

`Exceptions`

path’ is null.

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

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

拒绝访问 path" 文件。

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

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