Class XzArchive

Class XzArchive

Namespace: Aspose.Zip.Xz
Assembly: Aspose.Zip.dll (25.1.0)

คลาสนี้แทนไฟล์ xz archive ใช้เพื่อสร้างและแยก xz archives

public class XzArchive : IArchive, IDisposable, IArchiveFileEntry

การสืบทอด

objectXzArchive

การใช้งาน

IArchive, IDisposable, IArchiveFileEntry

สมาชิกที่สืบทอด

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

ตัวสร้าง

XzArchive(XzArchiveSettings)

เริ่มต้นอินสแตนซ์ใหม่ของคลาส Aspose.Zip.Xz.XzArchive และสร้าง archive ในรูปแบบ xz

public XzArchive(XzArchiveSettings settings = null)

พารามิเตอร์

settings XzArchiveSettings

ชุดการตั้งค่าที่เฉพาะเจาะจงสำหรับ xz archive: ขนาดพจนานุกรม, ขนาดบล็อก, ประเภทการตรวจสอบ

XzArchive(Stream)

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

public XzArchive(Stream source)

พารามิเตอร์

source Stream

แหล่งที่มาของ archive

หมายเหตุ

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

ข้อยกเว้น

ArgumentException

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

ArgumentNullException

source เป็น null

XzArchive(string)

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

public XzArchive(string path)

พารามิเตอร์

path string

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

หมายเหตุ

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

ข้อยกเว้น

ArgumentNullException

path เป็น null

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

ไม่พบไฟล์

DirectoryNotFoundException

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

IOException

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

วิธีการ

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);
        }
    }
}

ข้อยกเว้น

InvalidOperationException

หัวข้อ 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 และข้อมูลบริการไม่ได้ถูกอ่าน

SecurityException

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

ArgumentException

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

FileNotFoundException

ไม่พบไฟล์

UnauthorizedAccessException

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

ArgumentNullException

fileInfo เป็น null

DirectoryNotFoundException

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

IOException

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

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");
    }
}

ข้อยกเว้น

InvalidOperationException

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

ArgumentNullException

path เป็น null

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

ไม่พบไฟล์

DirectoryNotFoundException

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

IOException

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

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

พารามิเตอร์

destinationDirectory string

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

หมายเหตุ

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

ข้อยกเว้น

ArgumentNullException

destinationDirectory เป็น null

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

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

IOException

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

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 จะต้องสามารถค้นหาได้

ข้อยกเว้น

ArgumentException

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

ArgumentNullException

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");
}

ข้อยกเว้น

ArgumentNullException

destinationFileName เป็น null

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

ไฟล์ที่ 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");
}

ข้อยกเว้น

ArgumentException

สตรีม 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");
}

ข้อยกเว้น

SecurityException

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

ArgumentException

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

FileNotFoundException

ไม่พบไฟล์

UnauthorizedAccessException

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

ArgumentNullException

fileInfo เป็น null

DirectoryNotFoundException

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

IOException

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

SetSource(string)

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

public void SetSource(string sourcePath)

พารามิเตอร์

sourcePath string

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

ตัวอย่าง

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

ข้อยกเว้น

ArgumentNullException

sourcePath เป็น null

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 แบบไทย