Class XzArchive

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

source เป็น null

XzArchive(string)

เริ่มต้นอินสแตนซ์ใหม่ของคลาส Aspose.Zip.Xz.XzArchive ที่เตรียมไว้สำหรับการแยก

public XzArchive(string path)

พารามิเตอร์

path string

เส้นทางไปยังแหล่งที่มาของ archive

หมายเหตุ

ตัวสร้างนี้ไม่ทำการแยก ดูวิธี Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) สำหรับการแยก

ข้อยกเว้น

path เป็น null

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

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

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

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

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

ไม่พบไฟล์

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

InvalidOperationException

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

วิธีการ

Dispose()

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

public void Dispose()

Dispose(bool)

protected virtual void Dispose(bool disposing)

พารามิเตอร์

disposing bool

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

Extract(Stream)

แยก xz archive ไปยังสตรีม

public void Extract(Stream destination)

พารามิเตอร์

destination Stream

สตรีมสำหรับจัดเก็บข้อมูลที่ถูกแยก

ตัวอย่าง

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

ข้อยกเว้น

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

Extract(FileInfo)

แยก xz archive ไปยังไฟล์

public void Extract(FileInfo fileInfo)

พารามิเตอร์

fileInfo FileInfo

FileInfo สำหรับจัดเก็บข้อมูลที่ถูกแยก

ตัวอย่าง

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

ข้อยกเว้น

InvalidOperationException

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

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

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

ไม่พบไฟล์

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

fileInfo เป็น null

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

InvalidOperationException

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

Extract(string)

แยก xz archive ไปยังไฟล์ตามเส้นทาง

public FileInfo Extract(string path)

พารามิเตอร์

path string

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

คืนค่า

FileInfo

อินสแตนซ์ของ System.IO.FileInfo ที่ประกอบด้วยข้อมูลที่ถูกแยก

ตัวอย่าง

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

ข้อยกเว้น

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

path เป็น null

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

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

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

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

ไม่พบไฟล์

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

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

ExtractToDirectory(string)

แยกเนื้อหาของ archive ไปยังไดเรกทอรีที่ระบุ

public void ExtractToDirectory(string destinationDirectory)

พารามิเตอร์

destinationDirectory string

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

หมายเหตุ

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

ข้อยกเว้น

destinationDirectory เป็น null

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

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

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

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

Save(Stream)

บันทึก xz archive ไปยังสตรีมที่ให้มา

public void Save(Stream output)

พารามิเตอร์

output Stream

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

ตัวอย่าง

using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
    using (var archive = new XzArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(xzFile);
     }
}

หมายเหตุ

output จะต้องสามารถค้นหาได้

ข้อยกเว้น

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

output เป็น null

Save(string)

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

public void Save(string destinationFileName)

พารามิเตอร์

destinationFileName string

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

ตัวอย่าง

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

ข้อยกเว้น

destinationFileName เป็น null

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

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

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

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

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

SetSource(Stream)

ตั้งค่าคอนเทนต์ที่จะถูกบีบอัดภายใน archive

public void SetSource(Stream source)

พารามิเตอร์

source Stream

สตรีมข้อมูลนำเข้าสำหรับ archive

ตัวอย่าง

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

ข้อยกเว้น

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

SetSource(FileInfo)

ตั้งค่าคอนเทนต์ที่จะถูกบีบอัดภายใน archive

public void SetSource(FileInfo fileInfo)

พารามิเตอร์

fileInfo FileInfo

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

ตัวอย่าง

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

ข้อยกเว้น

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

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

ไม่พบไฟล์

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

fileInfo เป็น null

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

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

SetSource(string)

ตั้งค่าคอนเทนต์ที่จะถูกบีบอัดภายใน archive

public void SetSource(string sourcePath)

พารามิเตอร์

sourcePath string

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

ตัวอย่าง

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

ข้อยกเว้น

sourcePath เป็น null

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

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

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

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