Class LzipArchive
Namespace: Aspose.Zip.Lzip
Assembly: Aspose.Zip.dll (25.1.0)
คลาสนี้เป็นตัวแทนของไฟล์บีบอัด Lzip ใช้เพื่อสร้างหรือแยกไฟล์บีบอัด Lzip
public class LzipArchive : 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()
คอนสตรัคเตอร์
LzipArchive(LzipArchiveSettings)
เริ่มต้นอินสแตนซ์ใหม่ของ Aspose.Zip.Lzip.LzipArchive
public LzipArchive(LzipArchiveSettings settings = null)
พารามิเตอร์
settings
LzipArchiveSettings
การตั้งค่าของไฟล์บีบอัด lzip โดยกำหนดขนาดของพจนานุกรม
LzipArchive(Stream)
เริ่มต้นอินสแตนซ์ใหม่ของคลาส Aspose.Zip.Lzip.LzipArchive ที่เตรียมไว้สำหรับการดีคอมเพรส
public LzipArchive(Stream sourceStream)
พารามิเตอร์
sourceStream
Stream
แหล่งที่มาของไฟล์บีบอัด
หมายเหตุ
คอนสตรัคเตอร์นี้ไม่ทำการดีคอมเพรส ดูวิธีการ Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) สำหรับการดีคอมเพรส
ข้อยกเว้น
sourceStream
ไม่สามารถค้นหาได้
sourceStream
เป็น null
หัวข้อไม่ตรงกับประเภทไฟล์บีบอัด lzip
LzipArchive(string)
เริ่มต้นอินสแตนซ์ใหม่ของคลาส Aspose.Zip.Lzip.LzipArchive ที่เตรียมไว้สำหรับการดีคอมเพรส
public LzipArchive(string path)
พารามิเตอร์
path
string
เส้นทางไปยังแหล่งที่มาของไฟล์บีบอัด
ตัวอย่าง
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzipArchive(sourceLzipFile))
{
archive.Extract(extractedFile);
}
}
หมายเหตุ
คอนสตรัคเตอร์นี้ไม่ทำการดีคอมเพรส ดูวิธีการ Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) สำหรับการดีคอมเพรส
ข้อยกเว้น
path
เป็น null
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง
path
ว่างเปล่า มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง
การเข้าถึงไฟล์ path
ถูกปฏิเสธ
path
ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างมีความยาวเกินกว่าที่ระบบกำหนด ตัวอย่างเช่น บนแพลตฟอร์ม Windows เส้นทางต้องมีความยาวน้อยกว่า 248 ตัวอักษร และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 ตัวอักษร
ไฟล์ที่ path
มีเครื่องหมายทวิภาค (:) อยู่กลางสตริง
ไม่พบไฟล์
เส้นทางที่ระบุไม่ถูกต้อง เช่น อยู่บนไดรฟ์ที่ไม่ได้แมพ
ไฟล์ถูกเปิดอยู่แล้ว
หัวข้อไม่ตรงกับประเภทไฟล์บีบอัด lzip
คุณสมบัติ
Settings
ดึงการตั้งค่าของไฟล์บีบอัด lzip
public LzipArchiveSettings Settings { get; }
ค่า Property
วิธีการ
Dispose()
ดำเนินการตามงานที่กำหนดโดยแอปพลิเคชันที่เกี่ยวข้องกับการปล่อยหรือรีเซ็ตทรัพยากรที่ไม่จัดการ
public void Dispose()
Dispose(bool)
ดำเนินการตามงานที่กำหนดโดยแอปพลิเคชันที่เกี่ยวข้องกับการปล่อยหรือรีเซ็ตทรัพยากรที่ไม่จัดการ
protected virtual void Dispose(bool disposing)
พารามิเตอร์
disposing
bool
ว่าทรัพยากรที่จัดการควรจะถูกปล่อยหรือไม่
Extract(Stream)
แยกไฟล์บีบอัด lzip ไปยังสตรีม
public void Extract(Stream destination)
พารามิเตอร์
destination
Stream
สตรีมสำหรับเก็บข้อมูลที่ดีคอมเพรสแล้ว
ตัวอย่าง
using (FileStream sourceLzipFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzipArchive(sourceLzipFile))
{
archive.Extract(extractedFile);
}
}
}
ข้อยกเว้น
หัวข้อของไฟล์บีบอัดและข้อมูลบริการไม่ได้ถูกอ่าน
เกิดข้อผิดพลาดในข้อมูลในหัวข้อหรือ checksum
สตรีมปลายทางเป็น null
สตรีมปลายทางไม่รองรับการเขียน
Extract(FileInfo)
แยกไฟล์บีบอัด lzip ไปยังไฟล์
public void Extract(FileInfo fileInfo)
พารามิเตอร์
fileInfo
FileInfo
FileInfo สำหรับเก็บข้อมูลที่ดีคอมเพรสแล้ว
ตัวอย่าง
using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzipArchive(lzipFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
ข้อยกเว้น
หัวข้อของไฟล์บีบอัดและข้อมูลบริการไม่ได้ถูกอ่าน
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเปิด fileInfo
เส้นทางไฟล์ว่างเปล่าหรือมีเพียงช่องว่าง
ไม่พบไฟล์
เส้นทางไปยังไฟล์เป็นแบบอ่านอย่างเดียวหรือเป็นไดเรกทอรี
fileInfo
เป็น null
เส้นทางที่ระบุไม่ถูกต้อง เช่น อยู่บนไดรฟ์ที่ไม่ได้แมพ
ไฟล์ถูกเปิดอยู่แล้ว
Extract(string)
แยกไฟล์บีบอัด lzip ไปยังไฟล์ตามเส้นทาง
public void Extract(string path)
พารามิเตอร์
path
string
เส้นทางไปยังไฟล์ที่จะเก็บข้อมูลที่ดีคอมเพรสแล้ว
ตัวอย่าง
using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzipArchive(xzFile))
{
archive.Extract("extracted.bin");
}
}
ข้อยกเว้น
หัวข้อของไฟล์บีบอัดและข้อมูลบริการไม่ได้ถูกอ่าน
path
เป็น null
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง
path
ว่างเปล่า มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง
การเข้าถึงไฟล์ path
ถูกปฏิเสธ
path
ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างมีความยาวเกินกว่าที่ระบบกำหนด ตัวอย่างเช่น บนแพลตฟอร์ม Windows เส้นทางต้องมีความยาวน้อยกว่า 248 ตัวอักษร และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 ตัวอักษร
ไฟล์ที่ path
มีเครื่องหมายทวิภาค (:) อยู่กลางสตริง
ExtractToDirectory(string)
แยกเนื้อหาของไฟล์บีบอัดไปยังไดเรกทอรีที่กำหนด
public void ExtractToDirectory(string destinationDirectory)
พารามิเตอร์
destinationDirectory
string
เส้นทางไปยังไดเรกทอรีที่จะเก็บไฟล์ที่ถูกแยกออกมา
หมายเหตุ
หากไดเรกทอรีไม่อยู่ จะถูกสร้างขึ้น
ข้อยกเว้น
destinationDirectory
เป็น null
เส้นทางที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างมีความยาวเกินกว่าที่ระบบกำหนด ตัวอย่างเช่น บนแพลตฟอร์ม Windows เส้นทางต้องมีความยาวน้อยกว่า 248 ตัวอักษร และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 ตัวอักษร
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึงไดเรกทอรีที่มีอยู่
หากไดเรกทอรีไม่อยู่ เส้นทางมีเครื่องหมายทวิภาค (:) ที่ไม่ใช่ส่วนหนึ่งของป้ายชื่อไดรฟ์ (“C:")
destinationDirectory
เป็นสตริงที่มีความยาวเป็นศูนย์ มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้องหนึ่งตัวหรือมากกว่า คุณสามารถตรวจสอบอักขระที่ไม่ถูกต้องได้โดยใช้วิธีการ System.IO.Path.GetInvalidPathChars
-หรือ- เส้นทางถูกเติมด้วย หรือมีเพียงเครื่องหมายทวิภาค (:)
ไดเรกทอรีที่ระบุโดยเส้นทางเป็นไฟล์ -หรือ- ชื่อเครือข่ายไม่เป็นที่รู้จัก
Save(Stream)
บันทึกไฟล์บีบอัด lzip ไปยังสตรีมที่กำหนด
public void Save(Stream outputStream)
พารามิเตอร์
outputStream
Stream
สตรีมปลายทาง
ตัวอย่าง
using (FileStream lzFile = File.Open("archive.lz", FileMode.Create))
{
using (var archive = new LzipArchive())
{
archive.SetSource("data.bin");
archive.Save(lzFile);
}
}
หมายเหตุ
outputStream
ต้องสามารถค้นหาได้
ข้อยกเว้น
outputStream
ไม่รองรับการค้นหา
outputStream
เป็น null
Save(string)
บันทึกไฟล์บีบอัด lzip ไปยังไฟล์ปลายทางที่กำหนด
public void Save(string destinationFileName)
พารามิเตอร์
destinationFileName
string
เส้นทางของไฟล์บีบอัดที่สร้างขึ้น หากชื่อไฟล์ที่ระบุชี้ไปยังไฟล์ที่มีอยู่ จะถูกเขียนทับ
ตัวอย่าง
using (var archive = new LzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.lz");
}
ข้อยกเว้น
destinationFileName
เป็น null
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง
destinationFileName
ว่างเปล่า มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง
การเข้าถึงไฟล์ destinationFileName
ถูกปฏิเสธ
destinationFileName
ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างมีความยาวเกินกว่าที่ระบบกำหนด ตัวอย่างเช่น บนแพลตฟอร์ม Windows เส้นทางต้องมีความยาวน้อยกว่า 248 ตัวอักษร และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 ตัวอักษร
ไฟล์ที่ destinationFileName
มีเครื่องหมายทวิภาค (:) อยู่กลางสตริง
Save(FileInfo)
บันทึกไฟล์บีบอัด lzip ไปยังไฟล์ปลายทางที่กำหนด
public void Save(FileInfo destination)
พารามิเตอร์
destination
FileInfo
FileInfo ซึ่งจะถูกเปิดเป็นสตรีมปลายทาง
ตัวอย่าง
using (var archive = new LzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lz"));
}
ข้อยกเว้น
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเปิด destination
เส้นทางไฟล์ว่างเปล่าหรือมีเพียงช่องว่าง
ไม่พบไฟล์
เส้นทางไปยังไฟล์เป็นแบบอ่านอย่างเดียวหรือเป็นไดเรกทอรี
destination
เป็น null
เส้นทางที่ระบุไม่ถูกต้อง เช่น อยู่บนไดรฟ์ที่ไม่ได้แมพ
ไฟล์ถูกเปิดอยู่แล้ว
SetSource(Stream)
กำหนดเนื้อหาที่จะถูกบีบอัดภายในไฟล์บีบอัด
public void SetSource(Stream source)
พารามิเตอร์
source
Stream
สตรีมข้อมูลนำเข้าสำหรับไฟล์บีบอัด
ตัวอย่าง
using (var archive = new LzipArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lz");
}
ข้อยกเว้น
สตรีม source
ไม่สามารถค้นหาได้
SetSource(FileInfo)
กำหนดเนื้อหาที่จะถูกบีบอัดภายในไฟล์บีบอัด
public void SetSource(FileInfo fileInfo)
พารามิเตอร์
fileInfo
FileInfo
FileInfo ซึ่งจะถูกเปิดเป็นสตรีมข้อมูลนำเข้า
ตัวอย่าง
using (var archive = new LzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lz");
}
ข้อยกเว้น
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเปิด fileInfo
เส้นทางไฟล์ว่างเปล่าหรือมีเพียงช่องว่าง
ไม่พบไฟล์
เส้นทางไปยังไฟล์เป็นแบบอ่านอย่างเดียวหรือเป็นไดเรกทอรี
fileInfo
เป็น null
เส้นทางที่ระบุไม่ถูกต้อง เช่น อยู่บนไดรฟ์ที่ไม่ได้แมพ
ไฟล์ถูกเปิดอยู่แล้ว
SetSource(string)
กำหนดเนื้อหาที่จะถูกบีบอัดภายในไฟล์บีบอัด
public void SetSource(string path)
พารามิเตอร์
path
string
เส้นทางไปยังไฟล์ที่จะถูกบีบอัด
ตัวอย่าง
using (var archive = new LzipArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz");
}
ข้อยกเว้น
path
เป็น null
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง
path
ว่างเปล่า มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง
การเข้าถึงไฟล์ path
ถูกปฏิเสธ
path
ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างมีความยาวเกินกว่าที่ระบบกำหนด ตัวอย่างเช่น บนแพลตฟอร์ม Windows เส้นทางต้องมีความยาวน้อยกว่า 248 ตัวอักษร และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 ตัวอักษร
ไฟล์ที่ path
มีเครื่องหมายทวิภาค (:) อยู่กลางสตริง