Class IsoArchive
Namespace: Aspose.Zip.Iso
Assembly: Aspose.Zip.dll (25.1.0)
แทนที่ ISO archive (ISO 9660)
public sealed class IsoArchive : IArchive, IDisposableการสืบทอด
การใช้งาน
สมาชิกที่สืบทอดมา
object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
ตัวสร้าง
IsoArchive()
เริ่มต้นอินสแตนซ์ใหม่ของคลาส Aspose.Zip.Iso.IsoArchive และสร้าง ISO archive ว่างสำหรับการเพิ่มไฟล์และไดเรกทอรีใหม่
public IsoArchive()ตัวอย่าง
ตัวอย่างต่อไปนี้แสดงวิธีการสร้าง ISO archive ว่างใหม่และเพิ่มไฟล์ลงไป:
// สร้าง ISO archive ว่างใหม่
using(IsoArchive isoArchive = new IsoArchive())
{
// เพิ่มไฟล์ลงใน ISO archive
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// บันทึก ISO archive ลงในไฟล์
isoArchive.Save("new_archive.iso");
}IsoArchive(Stream, IsoLoadOptions)
เริ่มต้นอินสแตนซ์ใหม่ของคลาส Aspose.Zip.Iso.IsoArchive และจัดทำรายการรายการที่สามารถถูกดึงออกจาก archive
public IsoArchive(Stream sourceStream, IsoLoadOptions loadOptions = null)พารามิเตอร์
sourceStream Stream
แหล่งที่มาของ archive ต้องสามารถค้นหาได้
loadOptions IsoLoadOptions
ตัวเลือกในการโหลด archive
ตัวอย่าง
ตัวอย่างต่อไปนี้แสดงวิธีการดึงรายการทั้งหมดไปยังไดเรกทอรี
```csharp using (var archive = new IsoArchive(File.OpenRead("archive.iso"))) { archive.ExtractToDirectory("C:\\extracted"); } ```หมายเหตุ
ตัวสร้างนี้ไม่ทำการแตกไฟล์ใด ๆ
ข้อยกเว้น
sourceStream เป็น null
sourceStream ไม่สามารถค้นหาได้
sourceStream ไม่ใช่ ISO archive ที่ถูกต้อง
IsoArchive(string, IsoLoadOptions)
เริ่มต้นอินสแตนซ์ใหม่ของคลาส Aspose.Zip.Iso.IsoArchive และจัดทำรายการรายการที่สามารถถูกดึงออกจาก archive
public IsoArchive(string path, IsoLoadOptions loadOptions = null)พารามิเตอร์
path string
เส้นทางไปยังไฟล์ archive
loadOptions IsoLoadOptions
ตัวเลือกในการโหลด archive
ตัวอย่าง
ตัวอย่างต่อไปนี้แสดงวิธีการดึงรายการทั้งหมดไปยังไดเรกทอรี
```csharp using (var archive = new IsoArchive("archive.iso")) { archive.ExtractToDirectory("C:\\extracted"); } ```หมายเหตุ
ตัวสร้างนี้ไม่ทำการแตกไฟล์ใด ๆ
ข้อยกเว้น
path เป็น null
ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง
path ว่างเปล่า มีเฉพาะช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง
การเข้าถึงไฟล์ path ถูกปฏิเสธ
path ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างเกินความยาวสูงสุดที่กำหนดโดยระบบ สำหรับตัวอย่าง บนแพลตฟอร์มที่ใช้ Windows เส้นทางต้องมีความยาวน้อยกว่า 248 ตัวอักษร และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 ตัวอักษร
ไฟล์ที่ path มีเครื่องหมายโคลอน (:) อยู่กลางสตริง
ไม่พบไฟล์
เส้นทางที่ระบุไม่ถูกต้อง เช่น อยู่ในไดรฟ์ที่ไม่ได้แมพ
ไฟล์ถูกเปิดอยู่แล้ว
ไฟล์สั้นเกินไป
คุณสมบัติ
Entries
ได้รับรายการของประเภท Aspose.Zip.Iso.IsoEntry ที่ประกอบขึ้นเป็น archive
public ReadOnlyCollection<isoentry> Entries { get; }ค่า Property
ReadOnlyCollection<IsoEntry>
วิธีการ
CreateDirectory(string)
เพิ่มไดเรกทอรีลงในภาพ ISO
public IsoEntry CreateDirectory(string name)พารามิเตอร์
name string
เส้นทางของไดเรกทอรีใน ISO
คืนค่า
รายการ ISO ที่ประกอบขึ้น
ข้อยกเว้น
archive ถูกเปิดสำหรับการดึงข้อมูล
name เป็น null หรือว่างเปล่า
CreateEntry(string, string)
เพิ่มไฟล์ลงในภาพ ISO
public IsoEntry CreateEntry(string name, string filePath)พารามิเตอร์
name string
เส้นทางของไฟล์ใน ISO
filePath string
เส้นทางของไฟล์
คืนค่า
รายการ ISO ที่ประกอบขึ้น
ข้อยกเว้น
filePath เป็น null
filePath ว่างเปล่า มีเฉพาะช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง
การเข้าถึงไฟล์ filePath ถูกปฏิเสธ
filePath ที่ระบุเกินความยาวสูงสุดที่กำหนดโดยระบบ สำหรับตัวอย่าง บนแพลตฟอร์มที่ใช้ Windows เส้นทางต้องมีความยาวน้อยกว่า 248 ตัวอักษร และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 ตัวอักษร
ไฟล์ที่ filePath มีเครื่องหมายโคลอน (:) อยู่กลางสตริง
เกิดข้อผิดพลาดในการ I/O ขณะเปิดไฟล์
CreateEntry(string, Stream)
เพิ่มไฟล์ลงในภาพ ISO
public IsoEntry CreateEntry(string name, Stream source)พารามิเตอร์
name string
เส้นทางของไฟล์ใน ISO
source Stream
Stream ที่มีข้อมูลไฟล์
คืนค่า
รายการ ISO ที่ประกอบขึ้น
CreateEntry(string)
เพิ่มไฟล์ลงในภาพ ISO
public IsoEntry CreateEntry(string name)พารามิเตอร์
name string
เส้นทางของไดเรกทอรีใน ISO
คืนค่า
รายการ ISO ที่ประกอบขึ้น
ข้อยกเว้น
name เป็น null หรือว่างเปล่า
archive ถูกเปิดสำหรับการดึงข้อมูล
Dispose()
ดำเนินการงานที่กำหนดโดยแอปพลิเคชันที่เกี่ยวข้องกับการปล่อย ปลดปล่อย หรือรีเซ็ตทรัพยากรที่ไม่จัดการ
public void Dispose()ExtractToDirectory(string)
ดึงรายการทั้งหมดไปยังไดเรกทอรีที่ระบุ
public void ExtractToDirectory(string destinationDirectory)พารามิเตอร์
destinationDirectory string
ไดเรกทอรีเพื่อดึงรายการไปยัง
ตัวอย่าง
ตัวอย่างต่อไปนี้แสดงวิธีการดึงรายการทั้งหมดไปยังไดเรกทอรี:
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}ข้อยกเว้น
โยนเมื่อ archive อยู่ในโหมดแก้ไข
โยนเมื่อ destinationDirectory เป็น null
Save(string, IsoSaveOptions)
บันทึกภาพ ISO ลงในเส้นทางที่ระบุ
public void Save(string path, IsoSaveOptions saveOptions = null)พารามิเตอร์
path string
เส้นทางที่ภาพ ISO จะถูกบันทึก
saveOptions IsoSaveOptions
ตัวเลือกในการบันทึก ISO archive
ตัวอย่าง
ตัวอย่างต่อไปนี้แสดงวิธีการบันทึก ISO archive ลงในไฟล์:
// สร้าง ISO archive ว่างใหม่
using(IsoArchive isoArchive = new IsoArchive())
{
// เพิ่มไฟล์ลงใน ISO archive
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// บันทึก ISO archive ลงในไฟล์
isoArchive.Save("new_archive.iso");
}ข้อยกเว้น
โยนเมื่อ archive ไม่อยู่ในโหมดแก้ไข
โยนเมื่อ path เป็น null
โยนเมื่อเส้นทางที่ระบุไม่ถูกต้อง เช่น อยู่ในไดรฟ์ที่ไม่ได้แมพ
โยนเมื่อไฟล์ถูกเปิดอยู่แล้ว
โยนเมื่อการเข้าถึงไฟล์ path ถูกปฏิเสธ
โยนเมื่อ path ที่ระบุเกินความยาวสูงสุดที่กำหนดโดยระบบ
Save(Stream, IsoSaveOptions)
บันทึกภาพ ISO ลงใน stream ที่ระบุ
public void Save(Stream stream, IsoSaveOptions saveOptions = null)พารามิเตอร์
stream Stream
stream ที่ภาพ ISO จะถูกบันทึก
saveOptions IsoSaveOptions
ตัวเลือกในการบันทึก ISO archive
ตัวอย่าง
ตัวอย่างต่อไปนี้แสดงวิธีการบันทึก ISO archive ลงใน memory stream:
// สร้าง ISO archive ว่างใหม่
using(IsoArchive isoArchive = new IsoArchive())
{
// เพิ่มไฟล์ลงใน ISO archive
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// บันทึก ISO archive ลงใน memory stream
isoArchive.Save(memoryStream);
}ข้อยกเว้น
โยนเมื่อ archive ไม่อยู่ในโหมดแก้ไข
โยนเมื่อ stream เป็น null
โยนเมื่อ stream ไม่สามารถเขียนได้
