Class ZArchive
Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)
คลาสนี้แทนไฟล์บีบอัด Z (compress) ใช้เพื่อจัดทำหรือแยก Z archives
public class ZArchive : IArchive, IDisposable, IArchiveFileEntryการสืบทอด
การใช้งาน
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) สำหรับการแยก
ข้อยกเว้น
source ไม่สามารถค้นหาได้
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) สำหรับการแยก
ข้อยกเว้น
path เป็น null
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง
path ว่างเปล่า มีแต่ช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง
การเข้าถึงไฟล์ path ถูกปฏิเสธ
path ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างเกินความยาวสูงสุดที่กำหนดโดยระบบ ตัวอย่างเช่น บนแพลตฟอร์ม Windows เส้นทางต้องมีความยาวน้อยกว่า 248 ตัวอักษร และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 ตัวอักษร
ไฟล์ที่ path มีเครื่องหมายโคลอน (:) อยู่กลางสตริง
ไม่พบไฟล์
เส้นทางที่ระบุไม่ถูกต้อง เช่น อยู่บนไดรฟ์ที่ไม่ถูกแมพ
ไฟล์เปิดอยู่แล้ว
วิธีการ
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);
}
}
}ข้อยกเว้น
ไม่สามารถแยกข้อมูลได้
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"));
}
}ข้อยกเว้น
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเปิด fileInfo
เส้นทางไฟล์ว่างเปล่าหรือมีแต่ช่องว่าง
ไม่พบไฟล์
เส้นทางไปยังไฟล์เป็นแบบอ่านอย่างเดียวหรือเป็นไดเรกทอรี
fileInfo เป็น null
เส้นทางที่ระบุไม่ถูกต้อง เช่น อยู่บนไดรฟ์ที่ไม่ถูกแมพ
ไฟล์เปิดอยู่แล้ว
ไม่สามารถแยกข้อมูลได้
Extract(string)
แยก Z archive ไปยังไฟล์ตามเส้นทาง
public FileInfo Extract(string path)พารามิเตอร์
path string
เส้นทางไปยังไฟล์ที่จะเก็บข้อมูลที่ถูกแยก
ส่งคืน
ข้อมูลของไฟล์ที่ถูกแยก
ตัวอย่าง
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}ข้อยกเว้น
path เป็น null
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง
path ว่างเปล่า มีแต่ช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง
การเข้าถึงไฟล์ path ถูกปฏิเสธ
path ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างเกินความยาวสูงสุดที่กำหนดโดยระบบ ตัวอย่างเช่น บนแพลตฟอร์ม Windows เส้นทางต้องมีความยาวน้อยกว่า 248 ตัวอักษร และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 ตัวอักษร
ไฟล์ที่ path มีเครื่องหมายโคลอน (:) อยู่กลางสตริง
ไม่สามารถแยกข้อมูลได้
ExtractToDirectory(string)
แยกเนื้อหาของ archive ไปยังไดเรกทอรีที่กำหนด
public void ExtractToDirectory(string destinationDirectory)พารามิเตอร์
destinationDirectory string
เส้นทางไปยังไดเรกทอรีที่จะวางไฟล์ที่ถูกแยก
หมายเหตุ
หากไดเรกทอรีไม่มีอยู่ จะถูกสร้างขึ้น
ข้อยกเว้น
destinationDirectory เป็น null
path ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างเกินความยาวสูงสุดที่กำหนดโดยระบบ ตัวอย่างเช่น บนแพลตฟอร์ม Windows เส้นทางต้องมีความยาวน้อยกว่า 248 ตัวอักษร และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 ตัวอักษร
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึงไดเรกทอรีที่มีอยู่
หากไดเรกทอรีไม่มีอยู่ เส้นทางมีเครื่องหมายโคลอน (:) ที่ไม่เป็นส่วนหนึ่งของป้ายชื่อไดรฟ์ (“C:")
destinationDirectory เป็นสตริงที่มีความยาวเป็นศูนย์ มีแต่ช่องว่าง หรือมีอักขระที่ไม่ถูกต้องหนึ่งตัวหรือมากกว่า คุณสามารถตรวจสอบอักขระที่ไม่ถูกต้องได้โดยใช้วิธี System.IO.Path.GetInvalidPathChars
-หรือ- เส้นทางมีการเติมด้วยเครื่องหมายโคลอน (:)
ไดเรกทอรีที่ระบุโดยเส้นทางเป็นไฟล์ -หรือ- ชื่อเครือข่ายไม่เป็นที่รู้จัก
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 ต้องสามารถค้นหาได้
ข้อยกเว้น
output ไม่รองรับการค้นหา
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");
}ข้อยกเว้น
destinationFileName เป็น null
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง
destinationFileName ว่างเปล่า มีแต่ช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง
การเข้าถึงไฟล์ destinationFileName ถูกปฏิเสธ
destinationFileName ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างเกินความยาวสูงสุดที่กำหนดโดยระบบ ตัวอย่างเช่น บนแพลตฟอร์ม Windows เส้นทางต้องมีความยาวน้อยกว่า 248 ตัวอักษร และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 ตัวอักษร
ไฟล์ที่ 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");
}ข้อยกเว้น
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเปิด fileInfo
เส้นทางไฟล์ว่างเปล่าหรือมีแต่ช่องว่าง
ไม่พบไฟล์
เส้นทางไปยังไฟล์เป็นแบบอ่านอย่างเดียวหรือเป็นไดเรกทอรี
fileInfo เป็น null
เส้นทางที่ระบุไม่ถูกต้อง เช่น อยู่บนไดรฟ์ที่ไม่ถูกแมพ
ไฟล์เปิดอยู่แล้ว
SetSource(string)
ตั้งค่าเนื้อหาที่จะถูกบีบอัดภายใน archive
public void SetSource(string sourcePath)พารามิเตอร์
sourcePath string
เส้นทางไปยังไฟล์ที่จะเปิดเป็นสตรีมข้อมูลนำเข้า
ตัวอย่าง
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}ข้อยกเว้น
sourcePath เป็น null หรือสตริงว่างเปล่า
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึงทรัพยากร
sourcePath ว่างเปล่า มีแต่ช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง
การเข้าถึงไฟล์ sourcePath ถูกปฏิเสธ
sourcePath ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างเกินความยาวสูงสุดที่กำหนดโดยระบบ ตัวอย่างเช่น บนแพลตฟอร์ม Windows เส้นทางต้องมีความยาวน้อยกว่า 248 ตัวอักษร และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 ตัวอักษร
ไฟล์ที่ sourcePath มีเครื่องหมายโคลอน (:) อยู่กลางสตริง
