Class TarArchive

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

TarArchive(string)

เริ่มต้นอินสแตนซ์ใหม่ของคลาส Aspose.Zip.Tar.TarArchive และสร้างรายการรายการที่สามารถแยกออกจาก archive ได้

public TarArchive(string path)

พารามิเตอร์

path string

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

ตัวอย่าง

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

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

หมายเหตุ

ข้อยกเว้น

path เป็น null

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

UnauthorizedAccessException

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

เข้าถึงไฟล์ path ไม่ได้

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

DirectoryNotFoundException

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

FileNotFoundException

ไม่พบไฟล์

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

ReadOnlyCollection<TarEntry>

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

คุณสมบัติ

Entries

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

public ReadOnlyCollection<tarentry> Entries { get; }

ค่าคุณสมบัติ

วิธีการ

CreateEntries(DirectoryInfo, bool)

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

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

พารามิเตอร์

directory DirectoryInfo

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

includeRootDirectory bool

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

คืนค่า

archive ที่มีรายการที่ประกอบขึ้น

ตัวอย่าง

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

CreateEntries(string, bool)

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

พารามิเตอร์

sourceDirectory string

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

includeRootDirectory bool

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

คืนค่า

archive ที่มีรายการที่ประกอบขึ้น

ตัวอย่าง

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

ข้อยกเว้น

sourceDirectory เป็น null

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

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

CreateEntry(string, Stream, FileSystemInfo)

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

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)

พารามิเตอร์

name string

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

source Stream

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

fileInfo FileSystemInfo

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

คืนค่า

TarEntry

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

ตัวอย่าง

using (var archive = new TarArchive())
{
   archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
   archive.Save(tarFile);
}

หมายเหตุ

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

fileInfo สามารถอ้างถึง System.IO.DirectoryInfo หากรายการเป็นไดเรกทอรี

ข้อยกเว้น

name ยาวเกินไปสำหรับ tar ตามมาตรฐาน IEEE 1003.1-1998

ชื่อไฟล์เป็นส่วนหนึ่งของ name เกิน 100 สัญลักษณ์

CreateEntry(string, FileInfo, bool)

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

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

พารามิเตอร์

name string

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

fileInfo FileInfo

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

openImmediately bool

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

คืนค่า

TarEntry

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

ตัวอย่าง

FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
   archive.CreateEntry("data.bin", fi);
   archive.Save(tarFile);
}

หมายเหตุ

fileInfo สามารถอ้างถึง System.IO.DirectoryInfo หากรายการเป็นไดเรกทอรี

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

ข้อยกเว้น

name ยาวเกินไปสำหรับ tar ตามมาตรฐาน IEEE 1003.1-1998

ชื่อไฟล์เป็นส่วนหนึ่งของ name เกิน 100 สัญลักษณ์

CreateEntry(string, string, bool)

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

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)

พารามิเตอร์

name string

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

path string

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

openImmediately bool

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

คืนค่า

TarEntry

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

ตัวอย่าง

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

หมายเหตุ

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

ข้อยกเว้น

path เป็น null

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

UnauthorizedAccessException

path ว่างเปล่า มีเฉพาะช่องว่าง หรือมีอักขระที่ไม่ถูกต้อง - หรือ - ชื่อไฟล์เป็นส่วนหนึ่งของ name เกิน 100 สัญลักษณ์

เข้าถึงไฟล์ path ไม่ได้

path ที่ระบุ ชื่อไฟล์ หรือทั้งสองอย่างเกินความยาวสูงสุดที่กำหนดโดยระบบ - หรือ - name ยาวเกินไปสำหรับ tar ตามมาตรฐาน IEEE 1003.1-1998

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

DeleteEntry(TarEntry)

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

public TarArchive DeleteEntry(TarEntry entry)

พารามิเตอร์

entry TarEntry

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

คืนค่า

archive ที่มีรายการถูกลบออก

ตัวอย่าง

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

using (var archive = new TarArchive("archive.tar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputTarFile);
}

DeleteEntry(int)

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

public TarArchive DeleteEntry(int entryIndex)

พารามิเตอร์

entryIndex int

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

คืนค่า

ArgumentOutOfRangeException

archive ที่มีรายการถูกลบออก

ตัวอย่าง

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

ข้อยกเว้น

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 TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

หมายเหตุ

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

ข้อยกเว้น

path เป็น null

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

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

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

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

FromGZip(Stream)

แยก archive gzip ที่จัดเตรียมไว้และสร้าง Aspose.Zip.Tar.TarArchive จากข้อมูลที่แยกออก

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

public static TarArchive FromGZip(Stream source)

พารามิเตอร์

source Stream

แหล่งที่มาของ archive

คืนค่า

อินสแตนซ์ของ Aspose.Zip.Tar.TarArchive

หมายเหตุ

สตรีมการแยก GZip ไม่สามารถค้นหาได้ตามธรรมชาติของอัลกอริธึมการบีบอัด Tar archive ให้ฟังก์ชันในการแยกรายการตามความต้องการ ดังนั้นจึงต้องทำงานกับสตรีมที่สามารถค้นหาได้ภายใน

ข้อยกเว้น

archive เสียหาย

FromGZip(string)

แยก archive gzip ที่จัดเตรียมไว้และสร้าง Aspose.Zip.Tar.TarArchive จากข้อมูลที่แยกออก

public static TarArchive FromGZip(string path)

พารามิเตอร์

path string

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

คืนค่า

อินสแตนซ์ของ Aspose.Zip.Tar.TarArchive

หมายเหตุ

ข้อยกเว้น

archive เสียหาย

FromLZMA(Stream)

แยก archive LZMA ที่จัดเตรียมไว้และสร้าง Aspose.Zip.Tar.TarArchive จากข้อมูลที่แยกออก

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

public static TarArchive FromLZMA(Stream source)

พารามิเตอร์

source Stream

แหล่งที่มาของ archive

คืนค่า

อินสแตนซ์ของ Aspose.Zip.Tar.TarArchive

หมายเหตุ

สตรีมการแยก LZMA ไม่สามารถค้นหาได้ตามธรรมชาติของอัลกอริธึมการบีบอัด Tar archive ให้ฟังก์ชันในการแยกรายการตามความต้องการ ดังนั้นจึงต้องทำงานกับสตรีมที่สามารถค้นหาได้ภายใน

FromLZMA(string)

แยก archive LZMA ที่จัดเตรียมไว้และสร้าง Aspose.Zip.Tar.TarArchive จากข้อมูลที่แยกออก

public static TarArchive FromLZMA(string path)

พารามิเตอร์

path string

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

คืนค่า

อินสแตนซ์ของ Aspose.Zip.Tar.TarArchive

หมายเหตุ

FromLZip(Stream)

แยก archive lzip ที่จัดเตรียมไว้และสร้าง Aspose.Zip.Tar.TarArchive จากข้อมูลที่แยกออก

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

public static TarArchive FromLZip(Stream source)

พารามิเตอร์

source Stream

แหล่งที่มาของ archive

คืนค่า

อินสแตนซ์ของ Aspose.Zip.Tar.TarArchive

หมายเหตุ

สตรีมการแยก lzip ไม่สามารถค้นหาได้ตามธรรมชาติของอัลกอริธึมการบีบอัด Tar archive ให้ฟังก์ชันในการแยกรายการตามความต้องการ ดังนั้นจึงต้องทำงานกับสตรีมที่สามารถค้นหาได้ภายใน

FromLZip(string)

แยก archive lzip ที่จัดเตรียมไว้และสร้าง Aspose.Zip.Tar.TarArchive จากข้อมูลที่แยกออก

public static TarArchive FromLZip(string path)

พารามิเตอร์

path string

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

คืนค่า

อินสแตนซ์ของ Aspose.Zip.Tar.TarArchive

หมายเหตุ

FromXz(Stream)

แยก archive รูปแบบ xz ที่จัดเตรียมไว้และสร้าง Aspose.Zip.Tar.TarArchive จากข้อมูลที่แยกออก

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

public static TarArchive FromXz(Stream source)

พารามิเตอร์

source Stream

แหล่งที่มาของ archive

คืนค่า

อินสแตนซ์ของ Aspose.Zip.Tar.TarArchive

หมายเหตุ

Tar archive ให้ฟังก์ชันในการแยกรายการตามความต้องการ ดังนั้นจึงต้องทำงานกับสตรีมที่สามารถค้นหาได้ภายใน

FromXz(string)

แยก archive รูปแบบ xz ที่จัดเตรียมไว้และสร้าง Aspose.Zip.Tar.TarArchive จากข้อมูลที่แยกออก

public static TarArchive FromXz(string path)

พารามิเตอร์

path string

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

คืนค่า

อินสแตนซ์ของ Aspose.Zip.Tar.TarArchive

หมายเหตุ

FromZ(Stream)

แยก archive รูปแบบ Z ที่จัดเตรียมไว้และสร้าง Aspose.Zip.Tar.TarArchive จากข้อมูลที่แยกออก

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

public static TarArchive FromZ(Stream source)

พารามิเตอร์

source Stream

แหล่งที่มาของ archive

คืนค่า

อินสแตนซ์ของ Aspose.Zip.Tar.TarArchive

หมายเหตุ

FromZ(string)

แยก archive รูปแบบ Z ที่จัดเตรียมไว้และสร้าง Aspose.Zip.Tar.TarArchive จากข้อมูลที่แยกออก

public static TarArchive FromZ(string path)

พารามิเตอร์

path string

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

คืนค่า

อินสแตนซ์ของ Aspose.Zip.Tar.TarArchive

หมายเหตุ

FromZstandard(Stream)

แยก archive รูปแบบ Zstandard ที่จัดเตรียมไว้และสร้าง Aspose.Zip.Tar.TarArchive จากข้อมูลที่แยกออก

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

public static TarArchive FromZstandard(Stream source)

พารามิเตอร์

source Stream

แหล่งที่มาของ archive

คืนค่า

อินสแตนซ์ของ Aspose.Zip.Tar.TarArchive

ข้อยกเว้น

Zstandard stream เสียหายหรือไม่สามารถอ่านได้

ข้อมูลเสียหาย

FromZstandard(string)

แยก archive รูปแบบ Zstandard ที่จัดเตรียมไว้และสร้าง Aspose.Zip.Tar.TarArchive จากข้อมูลที่แยกออก

public static TarArchive FromZstandard(string path)

พารามิเตอร์

path string

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

คืนค่า

อินสแตนซ์ของ Aspose.Zip.Tar.TarArchive

ข้อยกเว้น

Zstandard stream เสียหายหรือไม่สามารถอ่านได้

ข้อมูลเสียหาย

Save(Stream, TarFormat?)

บันทึก archive ไปยังสตรีมที่ให้

public void Save(Stream output, TarFormat? format = null)

พารามิเตอร์

output Stream

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

format TarFormat?

กำหนดรูปแบบหัวข้อ tar ค่าที่เป็น null จะถูกพิจารณาว่าเป็น USTar เมื่อเป็นไปได้

ตัวอย่าง

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry1", "data.bin");
        archive.Save(tarFile);
    }
}

หมายเหตุ

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

ข้อยกเว้น

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

Save(string, TarFormat?)

บันทึก archive ไปยังไฟล์ปลายทางที่ให้

public void Save(string destinationFileName, TarFormat? format = null)

พารามิเตอร์

destinationFileName string

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

format TarFormat?

กำหนดรูปแบบหัวข้อ tar ค่าที่เป็น null จะถูกพิจารณาว่าเป็น USTar เมื่อเป็นไปได้

ตัวอย่าง

using (var archive = new TarArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("myarchive.tar");
}

หมายเหตุ

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

ข้อยกเว้น

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

destinationFileName เป็น null

DirectoryNotFoundException

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

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

UnauthorizedAccessException

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

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

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

FileNotFoundException

ไม่พบไฟล์

SaveGzipped(Stream, TarFormat?)

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

public void SaveGzipped(Stream output, TarFormat? format = null)

พารามิเตอร์

output Stream

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

format TarFormat?

กำหนดรูปแบบหัวข้อ tar ค่าที่เป็น null จะถูกพิจารณาว่าเป็น USTar เมื่อเป็นไปได้

ตัวอย่าง

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

หมายเหตุ

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

ข้อยกเว้น

output เป็น null

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

SaveGzipped(string, TarFormat?)

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

public void SaveGzipped(string path, TarFormat? format = null)

พารามิเตอร์

path string

format TarFormat?

กำหนดรูปแบบหัวข้อ tar ค่าที่เป็น null จะถูกพิจารณาว่าเป็น USTar เมื่อเป็นไปได้

ตัวอย่าง

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

SaveLZMACompressed(Stream, TarFormat?)

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

public void SaveLZMACompressed(Stream output, TarFormat? format = null)

พารามิเตอร์

output Stream

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

format TarFormat?

กำหนดรูปแบบหัวข้อ tar ค่าที่เป็น null จะถูกพิจารณาว่าเป็น USTar เมื่อเป็นไปได้

ตัวอย่าง

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

หมายเหตุ

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

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

ข้อยกเว้น

output เป็น null

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

SaveLZMACompressed(string, TarFormat?)

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

public void SaveLZMACompressed(string path, TarFormat? format = null)

พารามิเตอร์

path string

format TarFormat?

กำหนดรูปแบบหัวข้อ tar ค่าที่เป็น null จะถูกพิจารณาว่าเป็น USTar เมื่อเป็นไปได้

ตัวอย่าง

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

หมายเหตุ

SaveLzipped(Stream, TarFormat?)

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

public void SaveLzipped(Stream output, TarFormat? format = null)

พารามิเตอร์

output Stream

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

format TarFormat?

กำหนดรูปแบบหัวข้อ tar ค่าที่เป็น null จะถูกพิจารณาว่าเป็น USTar เมื่อเป็นไปได้

ตัวอย่าง

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

หมายเหตุ

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

ข้อยกเว้น

output เป็น null

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

SaveLzipped(string, TarFormat?)

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

public void SaveLzipped(string path, TarFormat? format = null)

พารามิเตอร์

path string

format TarFormat?

กำหนดรูปแบบหัวข้อ tar ค่าที่เป็น null จะถูกพิจารณาว่าเป็น USTar เมื่อเป็นไปได้

ตัวอย่าง

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

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

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

public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)

พารามิเตอร์

output Stream

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

format TarFormat?

กำหนดรูปแบบหัวข้อ tar ค่าที่เป็น null จะถูกพิจารณาว่าเป็น USTar เมื่อเป็นไปได้

settings XzArchiveSettings

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

ตัวอย่าง

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

หมายเหตุ

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

ข้อยกเว้น

output เป็น null

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

SaveXzCompressed(string, TarFormat?, XzArchiveSettings)

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

public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)

พารามิเตอร์

path string

format TarFormat?

กำหนดรูปแบบหัวข้อ tar ค่าที่เป็น null จะถูกพิจารณาว่าเป็น USTar เมื่อเป็นไปได้

settings XzArchiveSettings

ตัวอย่าง

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

SaveZCompressed(Stream, TarFormat?)

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

public void SaveZCompressed(Stream output, TarFormat? format = null)

พารามิเตอร์

output Stream

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

format TarFormat?

กำหนดรูปแบบหัวข้อ tar ค่าที่เป็น null จะถูกพิจารณาว่าเป็น USTar เมื่อเป็นไปได้

ตัวอย่าง

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

หมายเหตุ

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

ข้อยกเว้น

output เป็น null

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

SaveZCompressed(string, TarFormat?)

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

public void SaveZCompressed(string path, TarFormat? format = null)

พารามิเตอร์

path string

format TarFormat?

กำหนดรูปแบบหัวข้อ tar ค่าที่เป็น null จะถูกพิจารณาว่าเป็น USTar เมื่อเป็นไปได้

ตัวอย่าง

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

SaveZstandard(Stream, TarFormat?)

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

public void SaveZstandard(Stream output, TarFormat? format = null)

พารามิเตอร์

output Stream

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

format TarFormat?

กำหนดรูปแบบหัวข้อ tar ค่าที่เป็น null จะถูกพิจารณาว่าเป็น USTar เมื่อเป็นไปได้

ตัวอย่าง

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

หมายเหตุ

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

ข้อยกเว้น

output เป็น null