Class XzArchive
Namespace: Aspose.Zip.Xz
Assembly: Aspose.Zip.dll (25.1.0)
คลาสนี้แทนไฟล์ xz archive ใช้เพื่อสร้างและแยก xz archives
public class XzArchive : 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()
ตัวสร้าง
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) สำหรับการแยก
ข้อยกเว้น
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
มีเครื่องหมายโคลอน (:) อยู่กลางสตริง
ไม่พบไฟล์
เส้นทางที่ระบุไม่ถูกต้อง เช่น อยู่บนไดรฟ์ที่ไม่ได้แมพ
ไฟล์ถูกเปิดอยู่แล้ว
วิธีการ
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"));
}
}
ข้อยกเว้น
หัวข้อ archive และข้อมูลบริการไม่ได้ถูกอ่าน
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเปิด fileInfo
เส้นทางไฟล์ว่างเปล่าหรือมีแต่ช่องว่าง
ไม่พบไฟล์
เส้นทางไปยังไฟล์เป็นแบบอ่านอย่างเดียวหรือเป็นไดเรกทอรี
fileInfo
เป็น null
เส้นทางที่ระบุไม่ถูกต้อง เช่น อยู่บนไดรฟ์ที่ไม่ได้แมพ
ไฟล์ถูกเปิดอยู่แล้ว
Extract(string)
แยก xz archive ไปยังไฟล์ตามเส้นทาง
public FileInfo Extract(string path)
พารามิเตอร์
path
string
เส้นทางไปยังไฟล์ที่จะเก็บข้อมูลที่ถูกแยก
คืนค่า
อินสแตนซ์ของ 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
, ชื่อไฟล์, หรือทั้งสองอย่างเกินความยาวสูงสุดที่กำหนดโดยระบบ ตัวอย่างเช่น บนแพลตฟอร์มที่ใช้ 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
-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 ตัวอักษร
ไฟล์ที่ sourcePath
มีเครื่องหมายโคลอน (:) อยู่กลางสตริง