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