Class TarArchive

Class TarArchive

ชื่อพื้นที่: Aspose.Zip.Tar การประกอบ: Aspose.Zip.dll (25.5.0)

คลาสนี้แสดงให้เห็นถึงไฟล์ archive tar ใช้ไฟล์นี้ในการประกอบ, extract หรือ update archives tar

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

Implements

IArchive , IDisposable

อนุญาโตตุลาการ

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

TarArchive()

เริ่มต้นตัวอย่างใหม่ของคลาส Aspose.Zip.Tar.TarArchive

public TarArchive()

Examples

ตัวอย่างต่อไปนี้แสดงให้เห็นวิธีการบีบอัดไฟล์

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

TarArchive(Stream)

เปิดตัวตัวอย่างใหม่ของคลาส Aspose.Zip.Archive และประกอบรายการเข้าที่สามารถสกัดจากเอกสาร

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

แหล่งกําเนิดของเอกสาร มันต้องค้นหา

Examples

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

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

Remarks

ผู้ก่อสร้างนี้ไม่ถอดรหัสใด ๆ ดู Aspose.Zip.Tar.TarEntry.Open method สําหรับถอดรหัส

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(รั้ว)

เปิดตัวตัวอย่างใหม่ของคลาส Aspose.Zip.TarArchive และประกอบรายการป้อนที่สามารถถอดออกจากเอกสาร

public TarArchive(string path)

Parameters

path string

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

Examples

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

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

Remarks

ผู้ก่อสร้างนี้ไม่ถอดรหัสใด ๆ ดู Aspose.Zip.Tar.TarEntry.Open method สําหรับถอดรหัส

Exceptions

ArgumentNullException

path’ is null.

SecurityException

ผู้โทรไม่ได้รับอนุญาตให้เข้าถึง

ArgumentException

path" เป็นที่ว่างเปล่ามีพื้นที่สีขาวเท่านั้นหรือมีตัวอักษรที่ไม่ถูกต้อง

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

ไฟล์ใน path" มีคอลัมน์ (:) ในส่วนกลางของเส้น

FileNotFoundException

ไฟล์ไม่ได้พบ

DirectoryNotFoundException

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

IOException

ไฟล์นี้เปิดแล้ว

Properties

Entries

ได้รับป้อนของ Aspose.Zip.Tar.TarEntry หมายเลขที่สร้างเอกสาร

public ReadOnlyCollection<tarentry> Entries { get; }

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

ReadOnlyCollection < TarEntry >

Methods

CreateEntries(DirectoryInfo, บอล)

เพิ่มไฟล์และไดเรกทอรีทั้งหมดในไดเรกทอรี

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

Parameters

directory DirectoryInfo

คู่มือการบีบอัด

includeRootDirectory bool

แสดงให้เห็นว่าจะรวมกล่องรากตัวเองหรือไม่

Returns

TarArchive

ไฟล์ที่ประกอบด้วยรายการ

Examples

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(บอล, บอล)

เพิ่มไฟล์และไดเรกทอรีทั้งหมดในไดเรกทอรี

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

Parameters

sourceDirectory string

คู่มือการบีบอัด

includeRootDirectory bool

แสดงให้เห็นว่าจะรวมกล่องรากตัวเองหรือไม่

Returns

TarArchive

ไฟล์ที่ประกอบด้วยรายการ

Examples

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

Exceptions

ArgumentNullException

sourceDirectory’ is null.

SecurityException

ผู้โทรไม่ได้รับอนุญาตที่จําเป็นในการเข้าถึง sourceDirectory'.

ArgumentException

sourceDirectory’ contains invalid characters such as “, <, >, or |.

PathTooLongException

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

CreateEntry(กระแส, กระแส, FileSystemInfo)

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

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

Parameters

name string

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

source Stream

การเข้าสู่ระบบสําหรับเข้าสู่ระบบ

fileInfo FileSystemInfo

metadata ของไฟล์หรือโฟลเดอร์ที่จะถูกบีบอัด

Returns

TarEntry

การเข้าสู่ระบบ

Examples

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

Remarks

ชื่อเข้าตั้งไว้เฉพาะภายในพารามิเตอร์ ชื่อไฟล์ที่ระบุไว้ในพารามิเตอร์ไม่ส่งผลต่อชื่อเข้า

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

Exceptions

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

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

CreateEntry(ลวด, FileInfo, Bool)

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

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

Parameters

name string

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

fileInfo FileInfo

metadata ของไฟล์หรือโฟลเดอร์ที่จะถูกบีบอัด

openImmediately bool

จริงๆถ้าคุณเปิดไฟล์ได้ทันทีหรือเปิดไฟล์ที่บันทึกไฟล์

Returns

TarEntry

การเข้าสู่ระบบ

Examples

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

Remarks

ชื่อเข้าตั้งไว้เฉพาะภายในพารามิเตอร์ ชื่อไฟล์ที่ระบุไว้ในพารามิเตอร์ไม่ส่งผลต่อชื่อเข้า

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

หากไฟล์จะเปิดโดยอัตโนมัติโดยใช้พารามิเตอร์จะถูกบล็อกจนกว่าไฟล์จะถูกกําจัด

Exceptions

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

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

CreateEntry(string, string, บอล)

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

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

Parameters

name string

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

path string

วิธีที่จะไฟล์จะถูกบีบอัด

openImmediately bool

จริงๆถ้าคุณเปิดไฟล์ได้ทันทีหรือเปิดไฟล์ที่บันทึกไฟล์

Returns

TarEntry

การเข้าสู่ระบบ

Examples

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

Remarks

ชื่อเข้าตั้งไว้เฉพาะภายในพารามิเตอร์ ชื่อไฟล์ที่ระบุไว้ในพารามิเตอร์ไม่ส่งผลต่อชื่อเข้า

หากไฟล์จะเปิดโดยอัตโนมัติโดยใช้พารามิเตอร์จะถูกบล็อกจนกว่าไฟล์จะถูกกําจัด

Exceptions

ArgumentNullException

path’ is null.

SecurityException

ผู้โทรไม่ได้รับอนุญาตให้เข้าถึง

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

ตัวอย่างเช่นบนแพลตฟอร์มที่ใช้ Windows เส้นทางควรมีขนาดน้อยกว่า 248 หมายเลขและชื่อไฟล์ควรมีขนาดน้อยกว่า 260 หมายเลข - หรือ - name’ เป็นยาวเกินไปสําหรับ tar ตามมาตรฐาน IEEE 1003.1-1998

NotSupportedException

ไฟล์ใน path" มีคอลัมน์ (:) ในส่วนกลางของเส้น

DeleteEntry(TarEntry)

ลบการปรากฏตัวครั้งแรกของรายการที่เฉพาะเจาะจงจากรายการรายการ

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

การเข้าสู่ระบบที่จะถอดออกจากรายการเข้าสู่ระบบ

Returns

TarArchive

ไฟล์ที่มีการเข้าสู่ระบบลบ

Examples

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

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

DeleteEntry(int)

ลบป้อนจากรายการป้อนโดย index

public TarArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

อัตราการเข้าสู่ระบบที่ต้องถูกลบ

Returns

TarArchive

ไฟล์ที่มีการเข้าสู่ระบบลบ

Examples

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

Exceptions

ArgumentOutOfRangeException

entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.

Dispose()

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

public void Dispose()

Dispose(บอล)

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

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

ไม่ว่าทรัพยากรที่จัดการควรจะถูกกําจัด

ExtractToDirectory(รั้ว)

extract all the files in the archive to the directory provided

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

เส้นทางไปยังไดเรกทอรีเพื่อวางไฟล์ที่สกัด

Examples

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

Remarks

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

Exceptions

ArgumentNullException

เส้นทางเป็นศูนย์

PathTooLongException

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

SecurityException

ผู้โทรไม่ได้รับอนุญาตที่จําเป็นในการเข้าถึงไดเรกทอรีที่มีอยู่

NotSupportedException

หากไดเรกทอรีไม่ได้มีเส้นทางมีตัวอักษรของ colon (:) ซึ่งไม่ได้เป็นส่วนหนึ่งของแท็กไดรฟ์ (“C:”).

ArgumentException

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

IOException

แผนที่ระบุโดยเส้นทางเป็นไฟล์ - หรือ - ชื่อเครือข่ายไม่ทราบ

จากGZip(Stream)

สารสกัดที่จัดหาไฟล์ gzip และประกอบด้วย Aspose.Zip.Tar.TarArchive จากข้อมูลที่สกัด

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

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

แหล่งกําเนิดของไฟล์

Returns

TarArchive

ตัวอย่างของ Aspose.Zip.Tar.TarArchive

Remarks

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

Exceptions

InvalidDataException

ไฟล์นี้ถูกทําลาย

จากGZip(รั้ว)

สารสกัดที่จัดหาไฟล์ gzip และประกอบด้วย Aspose.Zip.Tar.TarArchive จากข้อมูลที่สกัด

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

public static TarArchive FromGZip(string path)

Parameters

path string

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

Returns

TarArchive

ตัวอย่างของ Aspose.Zip.Tar.TarArchive

Remarks

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

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path" เป็นที่ว่างเปล่ามีพื้นที่สีขาวเท่านั้นหรือมีตัวอักษรที่ไม่ถูกต้อง

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

ไฟล์ใน path" เป็นรูปแบบที่ไม่ถูกต้อง

DirectoryNotFoundException

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

FileNotFoundException

ไฟล์ไม่ได้พบ

InvalidDataException

ไฟล์นี้ถูกทําลาย

จากLZ4(รั้ว)

สารสกัดที่จัดหาไฟล์ LZ4 และประกอบด้วย Aspose.Zip.tar.TarArchive จากข้อมูลที่ถูกดึงดูด

สิ่งสําคัญ: ไฟล์ LZ4 ได้รับการสกัดอย่างสมบูรณ์ภายในวิธีการนี้เนื้อหาของมันจะถูกเก็บไว้ภายใน โปรดทราบเกี่ยวกับการบริโภคหน่วยความจํา

public static TarArchive FromLZ4(string path)

Parameters

path string

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

Returns

TarArchive

ตัวอย่างของ Aspose.Zip.Tar.TarArchive

Remarks

กระแสสกัด LZ4 ไม่สามารถค้นหาได้ตามธรรมชาติของอัลกอริทึมการบีบอัด การจัดเก็บ Tar ให้ความสะดวกในการดึงบันทึกที่ตั้งใจดังนั้นจึงต้องดําเนินการกระแสที่มองหาภายใต้แถบ

Exceptions

ArgumentNullException

path’ is null.

SecurityException

ผู้โทรไม่ได้รับอนุญาตให้เข้าถึง

ArgumentException

path" เป็นที่ว่างเปล่ามีพื้นที่สีขาวเท่านั้นหรือมีตัวอักษรที่ไม่ถูกต้อง

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

ไฟล์ใน path" เป็นรูปแบบที่ไม่ถูกต้อง

DirectoryNotFoundException

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

FileNotFoundException

ไฟล์ไม่ได้พบ

EndOfStreamException

ไฟล์นั้นสั้นเกินไป

InvalidDataException

ไฟล์ที่มีการลงนามที่ผิด

จากLZ4(Stream)

สารสกัดที่จัดหาไฟล์ LZ4 และประกอบด้วย Aspose.Zip.tar.TarArchive จากข้อมูลที่ถูกดึงดูด

สิ่งสําคัญ: ไฟล์ LZ4 ได้รับการสกัดอย่างสมบูรณ์ภายในวิธีการนี้เนื้อหาของมันจะถูกเก็บไว้ภายใน โปรดทราบเกี่ยวกับการบริโภคหน่วยความจํา

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

แหล่งกําเนิดของไฟล์

Returns

TarArchive

ตัวอย่างของ Aspose.Zip.Tar.TarArchive

Remarks

กระแสสกัด LZ4 ไม่สามารถค้นหาได้ตามธรรมชาติของอัลกอริทึมการบีบอัด การจัดเก็บ Tar ให้ความสะดวกในการดึงบันทึกที่ตั้งใจดังนั้นจึงต้องดําเนินการกระแสที่มองหาภายใต้แถบ

Exceptions

ArgumentException

ไม่สามารถอ่านได้จาก source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

source" มีการลงนามที่ผิด

จากLZMA(Stream)

สารสกัดที่จัดหาไฟล์ LZMA และประกอบด้วย Aspose.Zip.Tar.TarArchive จากข้อมูลที่สกัด

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

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

แหล่งกําเนิดของไฟล์

Returns

TarArchive

ตัวอย่างของ Aspose.Zip.Tar.TarArchive

Remarks

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

Exceptions

InvalidDataException

ไฟล์นี้ถูกทําลาย

จากLZMA(รั้ว)

สารสกัดที่จัดหาไฟล์ LZMA และประกอบด้วย Aspose.Zip.Tar.TarArchive จากข้อมูลที่สกัด

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

public static TarArchive FromLZMA(string path)

Parameters

path string

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

Returns

TarArchive

ตัวอย่างของ Aspose.Zip.Tar.TarArchive

Remarks

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

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path" เป็นที่ว่างเปล่ามีพื้นที่สีขาวเท่านั้นหรือมีตัวอักษรที่ไม่ถูกต้อง

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

ไฟล์ใน path" เป็นรูปแบบที่ไม่ถูกต้อง

DirectoryNotFoundException

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

FileNotFoundException

ไฟล์ไม่ได้พบ

จากLZip(Stream)

สารสกัดจัดหาไฟล์ lzip และประกอบด้วย Aspose.Zip.Tar.TarArchive จากข้อมูลที่สกัด

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

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

แหล่งกําเนิดของไฟล์

Returns

TarArchive

ตัวอย่างของ Aspose.Zip.Tar.TarArchive

Remarks

กระแสการสกัด Lzip ไม่สามารถค้นหาได้ตามธรรมชาติของอัลกอริทึมการบีบอัด Tar archive ให้ความสะดวกในการสกัดบันทึกที่ผิดชอบดังนั้นจึงต้องดําเนินการกระแสที่ค้นหาภายใต้กระดาษ

Exceptions

InvalidDataException

ไฟล์นี้ถูกทําลาย

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

จากLZip(รั้ว)

สารสกัดจัดหาไฟล์ lzip และประกอบด้วย Aspose.Zip.Tar.TarArchive จากข้อมูลที่สกัด

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

public static TarArchive FromLZip(string path)

Parameters

path string

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

Returns

TarArchive

ตัวอย่างของ Aspose.Zip.Tar.TarArchive

Remarks

กระแสการสกัด Lzip ไม่สามารถค้นหาได้ตามธรรมชาติของอัลกอริทึมการบีบอัด Tar archive ให้ความสะดวกในการสกัดบันทึกที่ผิดชอบดังนั้นจึงต้องดําเนินการกระแสที่ค้นหาภายใต้กระดาษ

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path" เป็นที่ว่างเปล่ามีพื้นที่สีขาวเท่านั้นหรือมีตัวอักษรที่ไม่ถูกต้อง

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

ไฟล์ใน path" เป็นรูปแบบที่ไม่ถูกต้อง

DirectoryNotFoundException

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

FileNotFoundException

ไฟล์ไม่ได้พบ

InvalidDataException

ไฟล์นี้ถูกทําลาย

FromXz(Stream)

สารสกัดที่จัดหาไฟล์รูปแบบ xz และประกอบ Aspose.Zip.Tar.TarArchive จากข้อมูลที่สกัด

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

public static TarArchive FromXz(Stream source)

Parameters

source Stream

แหล่งกําเนิดของไฟล์

Returns

TarArchive

ตัวอย่างของ Aspose.Zip.Tar.TarArchive

Remarks

Tar archive ให้ความสะดวกในการดึงบันทึกที่ตั้งใจดังนั้นจึงต้องดําเนินการกระแสที่มองหาภายใต้กระดาษ

FromXz(รั้ว)

สารสกัดที่จัดหาไฟล์รูปแบบ xz และประกอบ Aspose.Zip.Tar.TarArchive จากข้อมูลที่สกัด

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

public static TarArchive FromXz(string path)

Parameters

path string

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

Returns

TarArchive

ตัวอย่างของ Aspose.Zip.Tar.TarArchive

Remarks

Tar archive ให้ความสะดวกในการดึงบันทึกที่ตั้งใจดังนั้นจึงต้องดําเนินการกระแสที่มองหาภายใต้กระดาษ

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path" เป็นที่ว่างเปล่ามีพื้นที่สีขาวเท่านั้นหรือมีตัวอักษรที่ไม่ถูกต้อง

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

ไฟล์ใน path" เป็นรูปแบบที่ไม่ถูกต้อง

DirectoryNotFoundException

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

FileNotFoundException

ไฟล์ไม่ได้พบ

จาก Z(Stream)

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

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

public static TarArchive FromZ(Stream source)

Parameters

source Stream

แหล่งกําเนิดของไฟล์

Returns

TarArchive

ตัวอย่างของ Aspose.Zip.Tar.TarArchive

Remarks

Tar archive ให้ความสะดวกในการดึงบันทึกที่ตั้งใจดังนั้นจึงต้องดําเนินการกระแสที่มองหาภายใต้กระดาษ

จาก Z(รั้ว)

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

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

public static TarArchive FromZ(string path)

Parameters

path string

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

Returns

TarArchive

ตัวอย่างของ Aspose.Zip.Tar.TarArchive

Remarks

Tar archive ให้ความสะดวกในการดึงบันทึกที่ตั้งใจดังนั้นจึงต้องดําเนินการกระแสที่มองหาภายใต้กระดาษ

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path" เป็นที่ว่างเปล่ามีพื้นที่สีขาวเท่านั้นหรือมีตัวอักษรที่ไม่ถูกต้อง

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

ไฟล์ใน path" เป็นรูปแบบที่ไม่ถูกต้อง

DirectoryNotFoundException

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

FileNotFoundException

ไฟล์ไม่ได้พบ

FromZstandard(Stream)

สารสกัดจัดหา Zstandard archive และประกอบ Aspose.Zip.Tar.TarArchive จากข้อมูลที่สกัด

สิ่งสําคัญ: ไฟล์มาตรฐานจะถูกสกัดอย่างสมบูรณ์ภายในวิธีการนี้เนื้อหาของมันจะเก็บไว้ภายใน โปรดทราบเกี่ยวกับการบริโภคหน่วยความจํา

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

แหล่งกําเนิดของไฟล์

Returns

TarArchive

ตัวอย่างของ Aspose.Zip.Tar.TarArchive

Exceptions

IOException

Zstandard Stream เป็น corrupt หรือไม่อ่านได้

InvalidDataException

ข้อมูลถูกทําลาย

FromZstandard(รั้ว)

สารสกัดจัดหา Zstandard archive และประกอบ Aspose.Zip.Tar.TarArchive จากข้อมูลที่สกัด

สิ่งสําคัญ: ไฟล์มาตรฐานจะถูกสกัดอย่างสมบูรณ์ภายในวิธีการนี้เนื้อหาของมันจะเก็บไว้ภายใน โปรดทราบเกี่ยวกับการบริโภคหน่วยความจํา

public static TarArchive FromZstandard(string path)

Parameters

path string

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

Returns

TarArchive

ตัวอย่างของ Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path" เป็นที่ว่างเปล่ามีพื้นที่สีขาวเท่านั้นหรือมีตัวอักษรที่ไม่ถูกต้อง

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

ไฟล์ใน path" เป็นรูปแบบที่ไม่ถูกต้อง

DirectoryNotFoundException

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

FileNotFoundException

ไฟล์ไม่ได้พบ

IOException

Zstandard Stream เป็น corrupt หรือไม่อ่านได้

InvalidDataException

ข้อมูลถูกทําลาย

Save(กระแสหรือ TarFormat?)

เก็บไฟล์ไปยังกระแสที่ให้

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

Parameters

output Stream

การไหลของเป้าหมาย

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

Examples

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

Remarks

จําเป็นต้องเขียนได้

Exceptions

ArgumentException

output’ is not writable. - or - output’ is the same stream we extract from.- OR -It is impossible to save archive in format’ due to format restrictions.

Save(วงกลม TarFormat)

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

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

Parameters

destinationFileName string

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

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

Examples

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

Remarks

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

Exceptions

ArgumentException

destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName’ is null.

PathTooLongException

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

DirectoryNotFoundException

ระบุ destinationFileName’ เป็น invalid, (เช่นมันอยู่ในไดรฟ์ที่ไม่ได้วาด)

IOException

ข้อผิดพลาด I / O ได้เกิดขึ้นเมื่อเปิดไฟล์

UnauthorizedAccessException

destinationFileName’ specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.

NotSupportedException

destinationFileName’ is in an invalid format.

FileNotFoundException

ไฟล์ไม่ได้พบ

SaveGzipped(กระแสหรือ TarFormat?)

เก็บไฟล์ไปยังกระแสโดยใช้การบีบอัด gzip

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

Parameters

output Stream

การไหลของเป้าหมาย

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

Examples

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);
        }
    }
}

Remarks

จําเป็นต้องเขียนได้

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(วงกลม TarFormat)

เก็บไฟล์ไปยังไฟล์ตามเส้นทางโดยใช้การบีบอัด gzip

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

Parameters

path string

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

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

Examples

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");
    }
}

Exceptions

UnauthorizedAccessException

ผู้โทรไม่ได้รับอนุญาตที่ต้องการ - หรือ path" ที่ระบุไฟล์หรือไดเรกทอรีเพียงอ่าน

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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

DirectoryNotFoundException

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

NotSupportedException

path’ is in an invalid format.

SaveLZ4บีบอัด(กระแสหรือ TarFormat?)

เก็บไฟล์ไปยังกระแสโดยใช้การบีบอัด LZ4

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

Parameters

output Stream

การไหลของเป้าหมาย

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

Examples

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

Remarks

จําเป็นต้องเขียนได้

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLZ4บีบอัด(วงกลม TarFormat)

เก็บไฟล์ไปยังไฟล์ตามเส้นทางด้วย LZ4 การบีบอัด

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

Parameters

path string

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

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

Examples

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

Exceptions

UnauthorizedAccessException

ผู้โทรไม่ได้รับอนุญาตที่ต้องการ - หรือ path" ที่ระบุไฟล์หรือไดเรกทอรีเพียงอ่าน

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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

DirectoryNotFoundException

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

NotSupportedException

path’ is in an invalid format.

ป้องกันการบีบอัด(กระแสหรือ TarFormat?)

เก็บไฟล์ไปยังไหลผ่านการบีบอัด LZMA

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

Parameters

output Stream

การไหลของเป้าหมาย

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

Examples

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);
        }
    }
}

Remarks

จําเป็นต้องเขียนได้

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

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

ป้องกันการบีบอัด(วงกลม TarFormat)

เก็บไฟล์ไปยังไฟล์โดยทางด้วย lzma การบีบอัด

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

Parameters

path string

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

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

Examples

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");
    }
}

Remarks

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

Exceptions

UnauthorizedAccessException

ผู้โทรไม่ได้รับอนุญาตที่ต้องการ - หรือ path" ที่ระบุไฟล์หรือไดเรกทอรีเพียงอ่าน

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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

DirectoryNotFoundException

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

NotSupportedException

path’ is in an invalid format.

SaveLzipped(กระแสหรือ TarFormat?)

เก็บไฟล์ไปยังกระแสด้วย lzip compression

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

Parameters

output Stream

การไหลของเป้าหมาย

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

Examples

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);
        }
    }
}

Remarks

จําเป็นต้องเขียนได้

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(วงกลม TarFormat)

เก็บไฟล์ไปยังไฟล์ตามเส้นทางด้วย lzip compression

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

Parameters

path string

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

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

Examples

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");
    }
}

Exceptions

UnauthorizedAccessException

ผู้โทรไม่ได้รับอนุญาตที่ต้องการ - หรือ path" ที่ระบุไฟล์หรือไดเรกทอรีเพียงอ่าน

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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

DirectoryNotFoundException

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

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(กระแส, TarFormat?, XzArchiveSettings)

เก็บไฟล์ไปยังกระแสโดยใช้การบีบอัด xz

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

Parameters

output Stream

การไหลของเป้าหมาย

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

settings XzArchiveSettings

ชุดการตั้งค่าของเอกสาร XZ ที่เฉพาะเจาะจง: ขนาดคําพูด, ขนาดบล็อก, ประเภทตรวจสอบ

Examples

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);
        }
    }
}

Remarks

กระแสควรจะเขียนได้

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(string, TarFormat?, XzArchiveSettings)

เก็บไฟล์ไปยังเส้นทางโดยเส้นทางโดยการบีบอัด xz

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

Parameters

path string

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

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

settings XzArchiveSettings

ชุดการตั้งค่าของเอกสาร XZ ที่เฉพาะเจาะจง: ขนาดคําพูด, ขนาดบล็อก, ประเภทตรวจสอบ

Examples

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");
    }
}

Exceptions

UnauthorizedAccessException

ผู้โทรไม่ได้รับอนุญาตที่ต้องการ - หรือ path" ที่ระบุไฟล์หรือไดเรกทอรีเพียงอ่าน

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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

DirectoryNotFoundException

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

NotSupportedException

path’ is in an invalid format.

บันทึก(กระแสหรือ TarFormat?)

เก็บไฟล์ไปยังกระแสโดยใช้การบีบอัด Z

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

Parameters

output Stream

การไหลของเป้าหมาย

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

Examples

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);
        }
    }
}

Remarks

จําเป็นต้องเขียนได้

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

บันทึก(วงกลม TarFormat)

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

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

Parameters

path string

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

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

Examples

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");
    }
}

Exceptions

UnauthorizedAccessException

ผู้โทรไม่ได้รับอนุญาตที่ต้องการ - หรือ path" ที่ระบุไฟล์หรือไดเรกทอรีเพียงอ่าน

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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

DirectoryNotFoundException

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

NotSupportedException

path’ is in an invalid format.

SaveZstandard(กระแสหรือ TarFormat?)

เก็บไฟล์ไปยังกระแสโดยใช้การบีบอัดมาตรฐาน

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

Parameters

output Stream

การไหลของเป้าหมาย

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

Examples

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);
        }
    }
}

Remarks

จําเป็นต้องเขียนได้

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(วงกลม TarFormat)

เก็บไฟล์ไปยังไฟล์ตามเส้นทางด้วยการบีบอัดมาตรฐาน

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

Parameters

path string

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

format TarFormat ?

Defines the tar header format Null value will be treated as USTar เมื่อเป็นไปได้

Examples

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

Exceptions

UnauthorizedAccessException

ผู้โทรไม่ได้รับอนุญาตที่ต้องการ - หรือ path" ที่ระบุไฟล์หรือไดเรกทอรีเพียงอ่าน

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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

DirectoryNotFoundException

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

NotSupportedException

path’ is in an invalid format.

 แบบไทย