Class Lz4Archive

Class Lz4Archive

ชื่อพื้นที่: Aspose.Zip.Lz4 การประกอบ: Aspose.Zip.dll (25.5.0)

คลาสนี้แสดงให้เห็นถึงไฟล์ไฟล์ LZ4 ใช้ไฟล์นี้เพื่อสกัดหรือประกอบเอกสาร Lz4

public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Lz4Archive

Implements

IArchive , IDisposable , IArchiveFileEntry

อนุญาโตตุลาการ

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

Lz4Archive(Stream)

เริ่มต้นตัวอย่างใหม่ของคลาส Aspose.Zip.Lz4.Lz4Archive ที่เตรียมพร้อมสําหรับการบีบอัด

public Lz4Archive(Stream sourceStream)

Parameters

sourceStream Stream

แหล่งกําเนิดของไฟล์

Examples

เปิดไฟล์จาก Stream และสกัดไปยัง A

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

Remarks

ผู้ก่อสร้างนี้ไม่ decompress. ดู Aspose.Zip.Lz4.Lz4Archive.Open method สําหรับ decompressing.

Exceptions

ArgumentException

ไม่สามารถอ่านจาก sourceStream'

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

sourceStream" มีการลงนามที่ผิดพลาด

Lz4Archive(รั้ว)

เปิดตัวตัวอย่างใหม่ของ Class Aspose.Zip.Lz4.Lz4Archive

public Lz4Archive(string path)

Parameters

path string

เส้นทางไปยังไฟล์ไฟล์

Examples

เปิดไฟล์จากไฟล์ตามเส้นทางและสกัดไปยังไฟล์

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

Remarks

ผู้ก่อสร้างนี้ไม่ decompress. ดู Aspose.Zip.Lz4.Lz4Archive.Open method สําหรับ decompressing.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

ผู้โทรไม่ได้รับอนุญาตให้เข้าถึง

ArgumentException

path" เป็นที่ว่างเปล่ามีพื้นที่สีขาวเท่านั้นหรือมีตัวอักษรที่ไม่ถูกต้อง

UnauthorizedAccessException

การเข้าถึงไฟล์ path" ถูกปฏิเสธ

PathTooLongException

ระบุ path’, ชื่อไฟล์, หรือทั้งสองเกินความยาวสูงสุดที่กําหนดโดยระบบ ตัวอย่างเช่นบนแพลตฟอร์มที่ใช้ Windows, เส้นทางจะต้องน้อยกว่า 248 หมายเลขและชื่อไฟล์จะต้องน้อยกว่า 260 หมายเลข

NotSupportedException

ไฟล์ใน path" มีคอลัมน์ (:) ในส่วนกลางของเส้น

EndOfStreamException

ไฟล์นั้นสั้นเกินไป

InvalidDataException

ข้อมูลในไฟล์มีการลงนามที่ผิด

Lz4Archive(Lz4ArchiveSetting)

เปิดตัวตัวอย่างใหม่ของคลาส Aspose.Zip.Lz4.Lc4Archive ที่เตรียมพร้อมสําหรับการบีบอัด

public Lz4Archive(Lz4ArchiveSetting settings = null)

Parameters

settings Lz4ArchiveSetting

การตั้งค่าของไฟล์ประกอบ

Methods

Dispose()

ทําหน้าที่ที่กําหนดโดยการใช้งานที่เกี่ยวข้องกับการปล่อยทรัพยากรที่ไม่ได้รับการจัดการหรือรีไซเคิล

public void Dispose()

Dispose(บอล)

ทําหน้าที่ที่กําหนดโดยการใช้งานที่เกี่ยวข้องกับการปล่อยทรัพยากรที่ไม่ได้รับการจัดการหรือรีไซเคิล

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

ไม่ว่าทรัพยากรที่จัดการควรจะถูกกําจัด

Extract(รั้ว)

extract the archive to the file by path

public FileInfo Extract(string path)

Parameters

path string

เส้นทางไปยังไฟล์เป้าหมาย หากไฟล์มีอยู่แล้วมันจะถูกเขียนเกินไป

Returns

FileInfo

ข้อมูลของไฟล์ที่สกัด

Exceptions

EndOfStreamException

กระแสแหล่งที่มาเป็นเรื่องสั้นเกินไป

InvalidDataException

บิตที่ผิดพบในขณะที่ decoding

NotSupportedException

รุ่น LZ4 นี้ไม่ได้รับการสนับสนุน

Extract(Stream)

extract the archive to the stream ที่ให้

public void Extract(Stream destination)

Parameters

destination Stream

จุดหมายปลายทาง Stream. ต้องการเขียนได้

Examples

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

Exceptions

ArgumentException

destination’ does not support writing.

EndOfStreamException

กระแสแหล่งที่มาเป็นเรื่องสั้นเกินไป

InvalidDataException

บิตที่ผิดพบในขณะที่ decoding

NotSupportedException

รุ่น LZ4 นี้ไม่ได้รับการสนับสนุน

InvalidOperationException

ไฟล์นี้จะเตรียมไว้สําหรับการประกอบ

ExtractToDirectory(รั้ว)

สารสกัดเนื้อหาของเอกสารไปยังไดเรกทอรีที่ให้

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

เส้นทางไปยังไดเรกทอรีเพื่อวางไฟล์ที่สกัด

Remarks

หากไดเรกทอรีไม่ได้มีมันจะถูกสร้างขึ้น

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

เส้นทางที่ระบุชื่อไฟล์หรือทั้งสองเกินความยาวสูงสุดที่กําหนดโดยระบบ ตัวอย่างเช่นบนแพลตฟอร์มที่ใช้ Windows เส้นทางจะต้องน้อยกว่า 248 หมายเลขและชื่อไฟล์จะต้องน้อยกว่า 260 หมายเลข

SecurityException

ผู้โทรไม่ได้รับอนุญาตที่จําเป็นในการเข้าถึงไดเรกทอรีที่มีอยู่

NotSupportedException

หากไดเรกทอรีไม่ได้มีเส้นทางมีตัวอักษรของ colon (:) ซึ่งไม่ได้เป็นส่วนหนึ่งของแท็กไดรฟ์ (“C:”).

ArgumentException

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

แผนที่ที่ระบุโดยเส้นทางเป็นไฟล์ -หรือ- ชื่อเครือข่ายไม่ทราบ

EndOfStreamException

กระแสแหล่งที่มาเป็นเรื่องสั้นเกินไป

InvalidDataException

บิตที่ผิดพบในขณะที่เริ่มต้นการ decoding

InvalidOperationException

ไฟล์นี้จะเตรียมไว้สําหรับการประกอบ

Open()

เปิดเอกสารสําหรับการสกัดและให้การไหลที่มีเนื้อหาเอกสาร

public Stream Open()

Returns

Stream

กระแสที่นําเสนอเนื้อหาของเอกสาร

Examples

extract the archive and copies the extracted content to file stream

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 < (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

คุณสามารถใช้วิธีการ Stream.CopyTo สําหรับ .NET 4.0 และสูงกว่า: unpacked.Kopy To(สกัด)

Remarks

Read from the stream to get the original content of a file ดูส่วนตัวอย่าง

Exceptions

EndOfStreamException

กระแสแหล่งที่มาเป็นเรื่องสั้นเกินไป

InvalidDataException

บิตที่ผิดพบในขณะที่เริ่มต้นการ decoding

InvalidOperationException

ไฟล์นี้จะเตรียมไว้สําหรับการประกอบ

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

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

InvalidOperationException

ไฟล์จะเตรียมสําหรับการสกัด - หรือ - แหล่งที่มาไม่ได้จัดหา

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

SecurityException

ผู้โทรไม่ได้รับอนุญาตที่จําเป็นในการเปิด destination"

ArgumentException

เส้นทางไฟล์นั้นว่างเปล่าหรือมีพื้นที่สีขาวเท่านั้น

FileNotFoundException

ไฟล์ไม่ได้พบ

UnauthorizedAccessException

เส้นทางไปยังไฟล์เป็นอ่านเท่านั้นหรือเป็นไดเรกทอรี

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

เส้นทางที่ระบุไม่ถูกต้องเช่นอยู่บนไดรฟ์ที่ไม่มีแผนที่

IOException

ไฟล์นี้เปิดแล้ว

InvalidOperationException

ไฟล์นี้พร้อมสําหรับการสกัด

Save(รั้ว)

บันทึกไฟล์ไปยังไฟล์ปลายทางที่ให้

public void Save(string destinationFileName)

Parameters

destinationFileName string

วิธีของไฟล์ที่จะสร้าง หากชื่อไฟล์ที่ระบุหมายถึงไฟล์ที่มีอยู่มันจะถูกเขียนเกินไป

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

ผู้โทรไม่ได้รับอนุญาตให้เข้าถึง

ArgumentException

destinationFileName’ เป็นที่ว่างเปล่ามีพื้นที่สีขาวเท่านั้นหรือมีตัวอักษรที่ไม่ถูกต้อง

UnauthorizedAccessException

การเข้าถึงไฟล์ destinationFileName’ ถูกปฏิเสธ

PathTooLongException

คําอธิบาย destinationFileName’, ชื่อไฟล์, หรือทั้งสองเกินความยาวสูงสุดที่กําหนดโดยระบบ ตัวอย่างเช่นบนแพลตฟอร์มที่ใช้ Windows, เส้นทางจะต้องน้อยกว่า 248 หมายเลขและชื่อไฟล์จะต้องน้อยกว่า 260 หมายเลข

NotSupportedException

ไฟล์ที่ destinationFileName’ มีคอลัมน์ (:) ในส่วนกลางของเส้น

InvalidOperationException

ไฟล์นี้พร้อมสําหรับการสกัด

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

InvalidOperationException

ไฟล์นี้พร้อมสําหรับการสกัด

SetSource(FileInfo)

ใส่เนื้อหาที่จะถูกบีบอัดภายในเอกสาร

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

การอ้างอิงถึงไฟล์ที่จะถูกบีบอัด

Examples

เปิดไฟล์จาก Stream และสกัดไปยัง A

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

Exceptions

InvalidOperationException

ไฟล์นี้พร้อมสําหรับการสกัด

SetSource(TarArchive, TarFormat)

ใส่เนื้อหาที่จะถูกบีบอัดภายในเอกสาร

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

Parameters

tarArchive TarArchive

ไฟล์ Tar จะถูกบีบอัด

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

ArgumentNullException

path’ is null.

SecurityException

ผู้โทรไม่ได้รับอนุญาตให้เข้าถึง

ArgumentException

path" เป็นที่ว่างเปล่ามีพื้นที่สีขาวเท่านั้นหรือมีตัวอักษรที่ไม่ถูกต้อง

UnauthorizedAccessException

การเข้าถึงไฟล์ path" ถูกปฏิเสธ

PathTooLongException

ระบุ path’, ชื่อไฟล์, หรือทั้งสองเกินความยาวสูงสุดที่กําหนดโดยระบบ ตัวอย่างเช่นบนแพลตฟอร์มที่ใช้ Windows, เส้นทางจะต้องน้อยกว่า 248 หมายเลขและชื่อไฟล์จะต้องน้อยกว่า 260 หมายเลข

NotSupportedException

ไฟล์ใน path" มีคอลัมน์ (:) ในส่วนกลางของเส้น

InvalidOperationException

ไฟล์นี้พร้อมสําหรับการสกัด

 แบบไทย