Class CpioArchive

sourceStream เป็น null

sourceStream ไม่สามารถค้นหาได้

InvalidDataException

sourceStream ไม่ใช่ archive cpio ที่ถูกต้อง

CpioArchive(string)

public CpioArchive(string path)

พารามิเตอร์

path string

เส้นทางไปยังไฟล์ archive

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีการแยกรายการทั้งหมดไปยังไดเรกทอรี

using (var archive = new CpioArchive("archive.cpio")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

หมายเหตุ

ข้อยกเว้น

path เป็น null

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง

UnauthorizedAccessException

path ว่างเปล่า มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง

การเข้าถึงไฟล์ path ถูกปฏิเสธ

path ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างเกินความยาวสูงสุดที่กำหนดโดยระบบ ตัวอย่างเช่น บนแพลตฟอร์มที่ใช้ Windows เส้นทางต้องมีความยาวน้อยกว่า 248 อักขระ และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 อักขระ

DirectoryNotFoundException

ไฟล์ที่ path มีโคลอน (:) อยู่กลางสตริง

FileNotFoundException

ไม่พบไฟล์

เส้นทางที่ระบุไม่ถูกต้อง เช่น อยู่ในไดรฟ์ที่ไม่ได้แมพ

ReadOnlyCollection<CpioEntry>

ไฟล์เปิดอยู่แล้ว

คุณสมบัติ

Entries

รับรายการของประเภท Aspose.Zip.Cpio.CpioEntry ที่ประกอบขึ้นเป็น archive

public ReadOnlyCollection<cpioentry> Entries { get; }

ค่าของคุณสมบัติ

วิธีการ

CreateEntries(string, bool)

เพิ่มไฟล์และไดเรกทรีทั้งหมดไปยัง archive โดยการค้นหาแบบ recursive ในไดเรกทรีที่กำหนด

public CpioArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

พารามิเตอร์

sourceDirectory string

ไดเรกทรีที่จะบีบอัด

includeRootDirectory bool

ระบุว่าจะแยกรวมไดเรกทรีหลักเองหรือไม่

คืนค่า

อินสแตนซ์ของ Cpio entry

ตัวอย่าง

using (FileStream cpioFile = File.Open("archive.cpio", FileMode.Create))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntries("C:\folder", false);
        archive.Save(cpioFile);
    }
}

ข้อยกเว้น

sourceDirectory เป็น null

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง sourceDirectory

sourceDirectory มีอักขระที่ไม่ถูกต้อง เช่น “, <, >, หรือ |

เส้นทางที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างเกินความยาวสูงสุดที่กำหนดโดยระบบ ตัวอย่างเช่น บนแพลตฟอร์มที่ใช้ Windows เส้นทางต้องมีความยาวน้อยกว่า 248 อักขระ และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 อักขระ เส้นทาง ชื่อไฟล์ หรือทั้งสองอย่างยาวเกินไป

sourceDirectory เป็นไฟล์ ไม่ใช่ไดเรกทรี

CreateEntries(DirectoryInfo, bool)

public CpioArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

พารามิเตอร์

directory DirectoryInfo

ไดเรกทรีที่จะบีบอัด

includeRootDirectory bool

ระบุว่าจะแยกรวมไดเรกทรีหลักเองหรือไม่

คืนค่า

อินสแตนซ์ของ Cpio entry

ตัวอย่าง

using (FileStream cpioFile = File.Open("archive.cpio", FileMode.Create))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
        archive.Save(cpioFile);
    }
}

ข้อยกเว้น

directory เป็น null

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง directory

directory เป็นไฟล์ ไม่ใช่ไดเรกทรี

CreateEntry(string, FileInfo, bool)

สร้างรายการเดียวใน archive

public CpioEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

พารามิเตอร์

name string

ชื่อของรายการ

fileInfo FileInfo

ข้อมูลเมตาของไฟล์หรือโฟลเดอร์ที่จะบีบอัด

openImmediately bool

True หากเปิดไฟล์ทันที มิฉะนั้นจะเปิดไฟล์เมื่อบันทึก archive

คืนค่า

CpioEntry

อินสแตนซ์ของ Cpio entry

ตัวอย่าง

FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new CpioArchive())
{
    archive.CreateEntry("test.bin", fileInfo);
    archive.Save("archive.cpio");
}

หมายเหตุ

หากเปิดไฟล์ทันทีด้วยพารามิเตอร์ openImmediately จะถูกบล็อกจนกว่า archive จะถูกปล่อย

ข้อยกเว้น

name เป็น null

name ว่างเปล่า

fileInfo เป็น null

CreateEntry(string, string, bool)

สร้างรายการเดียวใน archive

public CpioEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)

พารามิเตอร์

name string

ชื่อของรายการ

sourcePath string

เส้นทางไปยังไฟล์ที่จะบีบอัด

openImmediately bool

True หากเปิดไฟล์ทันที มิฉะนั้นจะเปิดไฟล์เมื่อบันทึก archive

คืนค่า

CpioEntry

อินสแตนซ์ของ Cpio entry

ตัวอย่าง

using (var archive = new CpioArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.cpio");
}

หมายเหตุ

ชื่อรายการถูกตั้งค่าเฉพาะในพารามิเตอร์ name ชื่อไฟล์ที่ระบุในพารามิเตอร์ sourcePath ไม่มีผลต่อชื่อรายการ

หากเปิดไฟล์ทันทีด้วยพารามิเตอร์ openImmediately จะถูกบล็อกจนกว่า archive จะถูกปล่อย

ข้อยกเว้น

sourcePath เป็น null

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง

UnauthorizedAccessException

sourcePath ว่างเปล่า มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง - หรือ - ชื่อไฟล์ใน name ยาวเกิน 100 อักขระ

การเข้าถึงไฟล์ sourcePath ถูกปฏิเสธ

sourcePath ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างเกินความยาวสูงสุดที่กำหนดโดยระบบ - หรือ - name ยาวเกินไปสำหรับ cpio

ไฟล์ที่ sourcePath มีโคลอน (:) อยู่กลางสตริง

CreateEntry(string, Stream)

สร้างรายการเดียวใน archive

public CpioEntry CreateEntry(string name, Stream source)

พารามิเตอร์

name string

ชื่อของรายการ

source Stream

สตรีมข้อมูลนำเข้าของรายการ

คืนค่า

CpioEntry

อินสแตนซ์ของ Cpio entry

ตัวอย่าง

using (var archive = new CpioArchive())
{
    archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
    archive.Save("archive.cpio");
}

ข้อยกเว้น

name เป็น null

source เป็น null

name ว่างเปล่า

DeleteEntry(CpioEntry)

ลบการเกิดขึ้นครั้งแรกของรายการเฉพาะจากรายการรายการ

public CpioArchive DeleteEntry(CpioEntry entry)

พารามิเตอร์

entry CpioEntry

รายการที่จะลบออกจากรายการรายการ

คืนค่า

อินสแตนซ์ของ Cpio entry

ตัวอย่าง

นี่คือวิธีที่คุณสามารถลบรายการทั้งหมดยกเว้นรายการสุดท้าย:

using (var archive = new CpioArchive("archive.cpio"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputCpioFile);
}

ข้อยกเว้น

entry เป็น null

DeleteEntry(int)

ลบรายการจากรายการรายการตามดัชนี

public CpioArchive DeleteEntry(int entryIndex)

พารามิเตอร์

entryIndex int

ดัชนีเริ่มต้นที่เป็นศูนย์ของรายการที่จะลบ

คืนค่า

ArgumentOutOfRangeException

archive ที่ลบรายการแล้ว

ตัวอย่าง

using (var archive = new CpioArchive("two_files.cpio"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.cpio");
}

ข้อยกเว้น

entryIndex น้อยกว่า 0 - หรือ - entryIndex เท่ากับหรือมากกว่า Entries จำนวน

Dispose()

ดำเนินการงานที่กำหนดโดยแอปพลิเคชันที่เกี่ยวข้องกับการปล่อย ปลดปล่อย หรือรีเซ็ตทรัพยากรที่ไม่ได้จัดการ

public void Dispose()

Dispose(bool)

protected virtual void Dispose(bool disposing)

พารามิเตอร์

disposing bool

ระบุว่าทรัพยากรที่จัดการควรถูกปล่อยหรือไม่

ExtractToDirectory(string)

แยกไฟล์ทั้งหมดใน archive ไปยังไดเรกทอรีที่จัดเตรียมไว้

public void ExtractToDirectory(string destinationDirectory)

พารามิเตอร์

destinationDirectory string

เส้นทางไปยังไดเรกทอรีที่จะวางไฟล์ที่แยกออกมา

ตัวอย่าง

using (var archive = new CpioArchive("archive.cpio")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

หมายเหตุ

หากไดเรกทรีไม่อยู่ จะถูกสร้างขึ้น

ข้อยกเว้น

path เป็น null

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึงไดเรกทรีที่มีอยู่

หากไดเรกทรีไม่อยู่ เส้นทางมีอักขระโคลอน (:) ที่ไม่ใช่ส่วนหนึ่งของป้ายชื่อไดรฟ์ (“C:")

path เป็นสตริงที่มีความยาวเป็นศูนย์ มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้องหนึ่งตัวหรือมากกว่า คุณสามารถสอบถามอักขระที่ไม่ถูกต้องได้โดยใช้วิธีการ System.IO.Path.GetInvalidPathChars - หรือ - path มีการเติมด้วย หรือมีเพียงอักขระโคลอน (:)

ไดเรกทรีที่ระบุโดย path เป็นไฟล์ - หรือ - ชื่อเครือข่ายไม่เป็นที่รู้จัก

Save(string, CpioFormat)

บันทึก archive ไปยังไฟล์ปลายทางที่จัดเตรียมไว้

public void Save(string destinationFileName, CpioFormat cpioFormat = CpioFormat.OldAscii)

พารามิเตอร์

destinationFileName string

เส้นทางของ archive ที่จะสร้าง หากชื่อไฟล์ที่ระบุชี้ไปยังไฟล์ที่มีอยู่ จะถูกเขียนทับ

cpioFormat CpioFormat

กำหนดรูปแบบหัวข้อ cpio

ตัวอย่าง

using (var archive = new CpioArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("archive.cpio");
}

หมายเหตุ

สามารถบันทึก archive ไปยังเส้นทางเดียวกับที่โหลดจาก อย่างไรก็ตามไม่แนะนำให้ใช้วิธีนี้เพราะวิธีนี้ใช้การคัดลอกไปยังไฟล์ชั่วคราว

ข้อยกเว้น

destinationFileName เป็นสตริงที่มีความยาวเป็นศูนย์ มีเพียงช่องว่าง หรือมีอักขระที่ไม่ถูกต้องหนึ่งตัวหรือมากกว่า ตามที่กำหนดโดย System.IO.Path.InvalidPathChars

destinationFileName เป็น null

DirectoryNotFoundException

destinationFileName ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างเกินความยาวสูงสุดที่กำหนดโดยระบบ ตัวอย่างเช่น บนแพลตฟอร์มที่ใช้ Windows เส้นทางต้องมีความยาวน้อยกว่า 248 อักขระ และชื่อไฟล์ต้องมีความยาวน้อยกว่า 260 อักขระ

destinationFileName ที่ระบุไม่ถูกต้อง (ตัวอย่างเช่น อยู่ในไดรฟ์ที่ไม่ได้แมพ)

UnauthorizedAccessException

เกิดข้อผิดพลาด I/O ขณะเปิดไฟล์

destinationFileName ระบุไฟล์ที่เป็นแบบอ่านอย่างเดียวและการเข้าถึงไม่ได้ - หรือ - เส้นทางที่ระบุเป็นไดเรกทรี - หรือ - ผู้เรียกไม่มีสิทธิ์ที่จำเป็น

destinationFileName อยู่ในรูปแบบที่ไม่ถูกต้อง

Save(Stream, CpioFormat)

บันทึก archive ไปยังสตรีมที่จัดเตรียมไว้

public void Save(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

พารามิเตอร์

output Stream

สตรีมปลายทาง

cpioFormat CpioFormat

กำหนดรูปแบบหัวข้อ cpio

ตัวอย่าง

using (FileStream cpioFile = File.Open("archive.cpio", FileMode.Create))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry1", "data.bin");        
        archive.Save(cpioFile);
    }
}

หมายเหตุ

output จะต้องสามารถเขียนได้

ข้อยกเว้น

output เป็น null

output ไม่สามารถเขียนได้ - หรือ - output เป็นสตรีมเดียวกันที่เราแยกออกจาก - หรือ - ไม่สามารถบันทึก archive ใน cpioFormat เนื่องจากข้อจำกัดของรูปแบบ

SaveGzipped(Stream, CpioFormat)

บันทึก archive ไปยังสตรีมพร้อมการบีบอัด gzip

public void SaveGzipped(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

พารามิเตอร์

output Stream

สตรีมปลายทาง

cpioFormat CpioFormat

กำหนดรูปแบบหัวข้อ cpio

ตัวอย่าง

using (FileStream result = File.OpenWrite("result.cpio.gz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

หมายเหตุ

output จะต้องสามารถเขียนได้

ข้อยกเว้น

output เป็น null

output ไม่สามารถเขียนได้

SaveGzipped(string, CpioFormat)

บันทึก archive ไปยังไฟล์ตามเส้นทางพร้อมการบีบอัด gzip

public void SaveGzipped(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

พารามิเตอร์

path string

cpioFormat CpioFormat

กำหนดรูปแบบหัวข้อ cpio

ตัวอย่าง

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.cpio.gz");
    }
}

SaveLZMACompressed(Stream, CpioFormat)

บันทึก archive ไปยังสตรีมพร้อมการบีบอัด LZMA

public void SaveLZMACompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

พารามิเตอร์

output Stream

สตรีมปลายทาง

cpioFormat CpioFormat

กำหนดรูปแบบหัวข้อ cpio

ตัวอย่าง

using (FileStream result = File.OpenWrite("result.cpio.lzma"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZMACompressed(result);
        }
    }
}

หมายเหตุ

output จะต้องสามารถเขียนได้

สำคัญ: archive cpio จะถูกประกอบขึ้นแล้วบีบอัดภายในวิธีนี้ เนื้อหาจะถูกเก็บรักษาไว้ภายใน ระวังการใช้หน่วยความจำ

SaveLZMACompressed(string, CpioFormat)

บันทึก archive ไปยังไฟล์ตามเส้นทางพร้อมการบีบอัด lzma

public void SaveLZMACompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

พารามิเตอร์

path string

cpioFormat CpioFormat

กำหนดรูปแบบหัวข้อ cpio

ตัวอย่าง

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZMACompressed("result.cpio.lzma");
    }
}

หมายเหตุ

SaveLzipped(Stream, CpioFormat)

บันทึก archive ไปยังสตรีมพร้อมการบีบอัด lzip

public void SaveLzipped(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

พารามิเตอร์

output Stream

สตรีมปลายทาง

cpioFormat CpioFormat

กำหนดรูปแบบหัวข้อ cpio

ตัวอย่าง

using (FileStream result = File.OpenWrite("result.cpio.lz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

หมายเหตุ

output จะต้องสามารถเขียนได้

ข้อยกเว้น

output เป็น null

output ไม่สามารถเขียนได้

SaveLzipped(string, CpioFormat)

บันทึก archive ไปยังไฟล์ตามเส้นทางพร้อมการบีบอัด lzip

public void SaveLzipped(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

พารามิเตอร์

path string

cpioFormat CpioFormat

กำหนดรูปแบบหัวข้อ cpio

ตัวอย่าง

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.cpio.lz");
    }
}

SaveXzCompressed(Stream, CpioFormat, XzArchiveSettings)

บันทึก archive ไปยังสตรีมพร้อมการบีบอัด xz

public void SaveXzCompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii, XzArchiveSettings settings = null)

พารามิเตอร์

output Stream

สตรีมปลายทาง

cpioFormat CpioFormat

กำหนดรูปแบบหัวข้อ cpio

settings XzArchiveSettings

ชุดการตั้งค่าของ archive xz โดยเฉพาะ: ขนาดของพจนานุกรม ขนาดบล็อก ประเภทการตรวจสอบ

ตัวอย่าง

using (FileStream result = File.OpenWrite("result.cpio.xz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveXzCompressed(result);
        }
    }
}

หมายเหตุ

output จะต้องสามารถเขียนได้

ข้อยกเว้น

output เป็น null

output ไม่สามารถเขียนได้

SaveXzCompressed(string, CpioFormat, XzArchiveSettings)

บันทึก archive ไปยังเส้นทางตามเส้นทางพร้อมการบีบอัด xz

public void SaveXzCompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii, XzArchiveSettings settings = null)

พารามิเตอร์

path string

cpioFormat CpioFormat

กำหนดรูปแบบหัวข้อ cpio

settings XzArchiveSettings

ตัวอย่าง

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveXzCompressed("result.cpio.xz");
    }
}

SaveZCompressed(Stream, CpioFormat)

บันทึก archive ไปยังสตรีมพร้อมการบีบอัด Z

public void SaveZCompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

พารามิเตอร์

output Stream

สตรีมปลายทาง

cpioFormat CpioFormat

กำหนดรูปแบบหัวข้อ cpio

ตัวอย่าง

using (FileStream result = File.OpenWrite("result.cpio.Z"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZCompressed(result);
        }
    }
}

หมายเหตุ

output จะต้องสามารถเขียนได้

ข้อยกเว้น

output เป็น null

output ไม่สามารถเขียนได้

SaveZCompressed(string, CpioFormat)

บันทึก archive ไปยังเส้นทางตามเส้นทางพร้อมการบีบอัด Z

public void SaveZCompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

พารามิเตอร์

path string

cpioFormat CpioFormat

กำหนดรูปแบบหัวข้อ cpio

ตัวอย่าง

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZCompressed("result.cpio.Z");
    }
}

SaveZstandard(Stream, CpioFormat)

บันทึก archive ไปยังสตรีมพร้อมการบีบอัด Zstandard

public void SaveZstandard(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

พารามิเตอร์

output Stream

สตรีมปลายทาง

cpioFormat CpioFormat

กำหนดรูปแบบหัวข้อ cpio

ตัวอย่าง

using (FileStream result = File.OpenWrite("result.cpio.zst"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZstandard(result);
        }
    }
}

หมายเหตุ

output จะต้องสามารถเขียนได้

ข้อยกเว้น

output เป็น null