Class LzipArchive

sourceStream ไม่สามารถค้นหาได้

sourceStream เป็น null

InvalidDataException

หัวข้อไม่ตรงกับประเภทไฟล์บีบอัด lzip

LzipArchive(string)

public LzipArchive(string path)

พารามิเตอร์

path string

เส้นทางไปยังแหล่งที่มาของไฟล์บีบอัด

ตัวอย่าง

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

หมายเหตุ

ข้อยกเว้น

path เป็น null

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง

path ว่างเปล่า มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง

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

path ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างมีความยาวเกินกว่าที่ระบบกำหนด ตัวอย่างเช่น บนแพลตฟอร์ม Windows เส้นทางต้องมีความยาวน้อยกว่า 248 ตัวอักษร และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 ตัวอักษร

ไฟล์ที่ path มีเครื่องหมายทวิภาค (:) อยู่กลางสตริง

ไม่พบไฟล์

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

InvalidOperationException

ไฟล์ถูกเปิดอยู่แล้ว

InvalidDataException

หัวข้อไม่ตรงกับประเภทไฟล์บีบอัด lzip

คุณสมบัติ

Settings

ดึงการตั้งค่าของไฟล์บีบอัด lzip

public LzipArchiveSettings Settings { get; }

ค่า Property

LzipArchiveSettings

วิธีการ

Dispose()

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

public void Dispose()

Dispose(bool)

protected virtual void Dispose(bool disposing)

พารามิเตอร์

disposing bool

ว่าทรัพยากรที่จัดการควรจะถูกปล่อยหรือไม่

Extract(Stream)

แยกไฟล์บีบอัด lzip ไปยังสตรีม

public void Extract(Stream destination)

พารามิเตอร์

destination Stream

สตรีมสำหรับเก็บข้อมูลที่ดีคอมเพรสแล้ว

ตัวอย่าง

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

ข้อยกเว้น

หัวข้อของไฟล์บีบอัดและข้อมูลบริการไม่ได้ถูกอ่าน

InvalidDataException

เกิดข้อผิดพลาดในข้อมูลในหัวข้อหรือ checksum

สตรีมปลายทางเป็น null

InvalidOperationException

สตรีมปลายทางไม่รองรับการเขียน

Extract(FileInfo)

แยกไฟล์บีบอัด lzip ไปยังไฟล์

public void Extract(FileInfo fileInfo)

พารามิเตอร์

fileInfo FileInfo

FileInfo สำหรับเก็บข้อมูลที่ดีคอมเพรสแล้ว

ตัวอย่าง

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

ข้อยกเว้น

หัวข้อของไฟล์บีบอัดและข้อมูลบริการไม่ได้ถูกอ่าน

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเปิด fileInfo

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

ไม่พบไฟล์

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

fileInfo เป็น null

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

InvalidOperationException

ไฟล์ถูกเปิดอยู่แล้ว

Extract(string)

แยกไฟล์บีบอัด lzip ไปยังไฟล์ตามเส้นทาง

public void Extract(string path)

พารามิเตอร์

path string

เส้นทางไปยังไฟล์ที่จะเก็บข้อมูลที่ดีคอมเพรสแล้ว

ตัวอย่าง

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

ข้อยกเว้น

หัวข้อของไฟล์บีบอัดและข้อมูลบริการไม่ได้ถูกอ่าน

path เป็น null

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง

path ว่างเปล่า มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง

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

ไฟล์ที่ path มีเครื่องหมายทวิภาค (:) อยู่กลางสตริง

ExtractToDirectory(string)

แยกเนื้อหาของไฟล์บีบอัดไปยังไดเรกทอรีที่กำหนด

public void ExtractToDirectory(string destinationDirectory)

พารามิเตอร์

destinationDirectory string

เส้นทางไปยังไดเรกทอรีที่จะเก็บไฟล์ที่ถูกแยกออกมา

หมายเหตุ

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

ข้อยกเว้น

destinationDirectory เป็น null

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

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึงไดเรกทอรีที่มีอยู่

หากไดเรกทอรีไม่อยู่ เส้นทางมีเครื่องหมายทวิภาค (:) ที่ไม่ใช่ส่วนหนึ่งของป้ายชื่อไดรฟ์ (“C:")

destinationDirectory เป็นสตริงที่มีความยาวเป็นศูนย์ มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้องหนึ่งตัวหรือมากกว่า คุณสามารถตรวจสอบอักขระที่ไม่ถูกต้องได้โดยใช้วิธีการ System.IO.Path.GetInvalidPathChars -หรือ- เส้นทางถูกเติมด้วย หรือมีเพียงเครื่องหมายทวิภาค (:)

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

Save(Stream)

บันทึกไฟล์บีบอัด lzip ไปยังสตรีมที่กำหนด

public void Save(Stream outputStream)

พารามิเตอร์

outputStream Stream

สตรีมปลายทาง

ตัวอย่าง

using (FileStream lzFile = File.Open("archive.lz", FileMode.Create))
{
    using (var archive = new LzipArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(lzFile);
     }
}

หมายเหตุ

outputStream ต้องสามารถค้นหาได้

ข้อยกเว้น

outputStream ไม่รองรับการค้นหา

outputStream เป็น null

Save(string)

บันทึกไฟล์บีบอัด lzip ไปยังไฟล์ปลายทางที่กำหนด

public void Save(string destinationFileName)

พารามิเตอร์

destinationFileName string

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

ตัวอย่าง

using (var archive = new LzipArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.lz");
}

ข้อยกเว้น

destinationFileName เป็น null

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง

destinationFileName ว่างเปล่า มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง

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

destinationFileName ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างมีความยาวเกินกว่าที่ระบบกำหนด ตัวอย่างเช่น บนแพลตฟอร์ม Windows เส้นทางต้องมีความยาวน้อยกว่า 248 ตัวอักษร และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 ตัวอักษร

ไฟล์ที่ destinationFileName มีเครื่องหมายทวิภาค (:) อยู่กลางสตริง

Save(FileInfo)

บันทึกไฟล์บีบอัด lzip ไปยังไฟล์ปลายทางที่กำหนด

public void Save(FileInfo destination)

พารามิเตอร์

destination FileInfo

FileInfo ซึ่งจะถูกเปิดเป็นสตรีมปลายทาง

ตัวอย่าง

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

ข้อยกเว้น

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเปิด destination

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

ไม่พบไฟล์

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

destination เป็น null

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

ไฟล์ถูกเปิดอยู่แล้ว

SetSource(Stream)

กำหนดเนื้อหาที่จะถูกบีบอัดภายในไฟล์บีบอัด

public void SetSource(Stream source)

พารามิเตอร์

source Stream

สตรีมข้อมูลนำเข้าสำหรับไฟล์บีบอัด

ตัวอย่าง

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

ข้อยกเว้น

สตรีม source ไม่สามารถค้นหาได้

SetSource(FileInfo)

กำหนดเนื้อหาที่จะถูกบีบอัดภายในไฟล์บีบอัด

public void SetSource(FileInfo fileInfo)

พารามิเตอร์

fileInfo FileInfo

FileInfo ซึ่งจะถูกเปิดเป็นสตรีมข้อมูลนำเข้า

ตัวอย่าง

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

ข้อยกเว้น

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเปิด fileInfo

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

ไม่พบไฟล์

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

fileInfo เป็น null

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

ไฟล์ถูกเปิดอยู่แล้ว

SetSource(string)

กำหนดเนื้อหาที่จะถูกบีบอัดภายในไฟล์บีบอัด

public void SetSource(string path)

พารามิเตอร์

path string

เส้นทางไปยังไฟล์ที่จะถูกบีบอัด

ตัวอย่าง

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

ข้อยกเว้น

path เป็น null

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง

path ว่างเปล่า มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง

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