Class ZArchive

Class ZArchive

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

คลาสนี้แทนไฟล์บีบอัด Z (compress) ใช้เพื่อจัดทำหรือแยก Z archives

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

การสืบทอด

objectZArchive

การใช้งาน

IArchive, IDisposable, IArchiveFileEntry

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

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

หมายเหตุ

ดูที่ https://docs.fileformat.com/compression/z/

ตัวสร้าง

ZArchive()

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

public ZArchive()

ZArchive(Stream, ZArchiveLoadOptions)

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

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

พารามิเตอร์

source Stream

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

loadOptions ZArchiveLoadOptions

ตัวเลือกในการโหลด archive

หมายเหตุ

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

ข้อยกเว้น

ArgumentException

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

ArgumentNullException

source เป็น null

ZArchive(string, ZArchiveLoadOptions)

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

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

พารามิเตอร์

path string

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

loadOptions ZArchiveLoadOptions

ตัวเลือกในการโหลด archive

หมายเหตุ

ตัวสร้างนี้ไม่ทำการแยก ดูที่วิธี Aspose.Zip.Z.ZArchive.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)

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

public void Extract(Stream destination)

พารามิเตอร์

destination Stream

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

ตัวอย่าง

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

ข้อยกเว้น

InvalidDataException

ไม่สามารถแยกข้อมูลได้

Extract(FileInfo)

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

public void Extract(FileInfo fileInfo)

พารามิเตอร์

fileInfo FileInfo

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

ตัวอย่าง

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

ข้อยกเว้น

SecurityException

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

ArgumentException

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

FileNotFoundException

ไม่พบไฟล์

UnauthorizedAccessException

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

ArgumentNullException

fileInfo เป็น null

DirectoryNotFoundException

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

IOException

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

InvalidDataException

ไม่สามารถแยกข้อมูลได้

Extract(string)

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

public FileInfo Extract(string path)

พารามิเตอร์

path string

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

ส่งคืน

FileInfo

ข้อมูลของไฟล์ที่ถูกแยก

ตัวอย่าง

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

ข้อยกเว้น

ArgumentNullException

path เป็น null

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

InvalidDataException

ไม่สามารถแยกข้อมูลได้

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 -หรือ- เส้นทางมีการเติมด้วยเครื่องหมายโคลอน (:)

IOException

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

Save(Stream, ZArchiveSaveOptions)

บันทึก xz archive ไปยังสตรีมที่กำหนด

public void Save(Stream output, ZArchiveSaveOptions settings = null)

พารามิเตอร์

output Stream

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

settings ZArchiveSaveOptions

การตั้งค่าตัวเลือกสำหรับการจัดทำ archive

ตัวอย่าง

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

หมายเหตุ

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

ข้อยกเว้น

ArgumentException

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

ArgumentNullException

output เป็น null

Save(string, ZArchiveSaveOptions)

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

public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)

พารามิเตอร์

destinationFileName string

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

settings ZArchiveSaveOptions

การตั้งค่าตัวเลือกสำหรับการจัดทำ archive

ตัวอย่าง

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

ข้อยกเว้น

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

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

พารามิเตอร์

fileInfo FileInfo

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

ตัวอย่าง

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

ข้อยกเว้น

SecurityException

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

ArgumentException

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

FileNotFoundException

ไม่พบไฟล์

UnauthorizedAccessException

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

ArgumentNullException

fileInfo เป็น null

DirectoryNotFoundException

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

IOException

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

SetSource(string)

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

public void SetSource(string sourcePath)

พารามิเตอร์

sourcePath string

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

ตัวอย่าง

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

ข้อยกเว้น

ArgumentNullException

sourcePath เป็น null หรือสตริงว่างเปล่า

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 แบบไทย