Class XarArchive

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

`XarArchive(ลวด, XarLoadOptions)`

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

public XarArchive(string path, XarLoadOptions loadOptions = null)

`Parameters`

path string

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

loadOptions XarLoadOptions

ตัวเลือกในการโหลดไฟล์ด้วย

`Examples`

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

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

`Remarks`

ผู้ก่อสร้างนี้ไม่ถอดรหัสใด ๆ ดู Aspose.Zip.Xar.XarFileEntry.Open วิธีการถอดรหัส

`Exceptions`

path’ is null.

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

UnauthorizedAccessException

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

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

DirectoryNotFoundException

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

NotSupportedException

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

FileNotFoundException

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

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

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

InvalidDataException

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

`Properties`

`Entries`

ได้รับการเข้าสู่ระบบของ Aspose.Zip.Xar.XarEntry หมายเลขที่สร้างเอกสาร

public IEnumerable<xarentry> Entries { get; }

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

IEnumerable < XarEntry >

`Methods`

`CreateEntries(บลอนด์, บลอนด์, XarCompressionSettings)`

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

public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

`Parameters`

sourceDirectory string

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

includeRootDirectory bool

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

compressionSettings XarCompressionSettings

การตั้งค่าการบีบอัดที่ใช้สําหรับการเพิ่ม Aspose.Zip.Xar.XarEntry รายการ

`Returns`

XarArchive

หลักฐานการเข้าสู่ระบบ

`Examples`

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(@"C:\folder", false);
        archive.Save(xarFile);
    }
}

`Exceptions`

sourceDirectory’ is null.

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

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

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

sourceDirectory’ stands for a file, not for a directory.

`CreateEntries(DirectoryInfo, บอล, XarCompressionSettings)`

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

public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

`Parameters`

directory DirectoryInfo

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

includeRootDirectory bool

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

compressionSettings XarCompressionSettings

การตั้งค่าการบีบอัดที่ใช้สําหรับการเพิ่ม Aspose.Zip.Xar.XarEntry รายการ

`Returns`

XarArchive

หลักฐานการเข้าสู่ระบบ

`Examples`

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(new DirectoryInfo(@"C:\folder"), false);
        archive.Save(xarFile);
    }
}

`Exceptions`

directory’ is null.

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

directory’ stands for a file, not for a directory.

`CreateEntry(ลวด, FileInfo, bool, XarCompressionSettings)`

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

public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

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

fileInfo FileInfo

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

openImmediately bool

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

compressionSettings XarCompressionSettings

การตั้งค่าการบีบอัดที่ใช้สําหรับการเพิ่ม Aspose.Zip.Xar.XarEntry รายการ

`Returns`

XarEntry

หลักฐานการเข้าสู่ระบบ

`Examples`

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

`Remarks`

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

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(string, string, bool, XarCompressionSettings)`

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

public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

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

sourcePath string

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

openImmediately bool

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

compressionSettings XarCompressionSettings

การตั้งค่าการบีบอัดที่ใช้สําหรับการเพิ่ม Aspose.Zip.Xar.XarEntry รายการ

`Returns`

XarEntry

หลักฐานการเข้าสู่ระบบ

`Examples`

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

`Remarks`

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

`Exceptions`

sourcePath’ is null.

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

UnauthorizedAccessException

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

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

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

NotSupportedException

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

ไม่สามารถแก้ไขไฟล์ xar

`CreateEntry(string, กระแส, XarCompressionSettings)`

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

public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

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

source Stream

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

compressionSettings XarCompressionSettings

การตั้งค่าการบีบอัดที่ใช้สําหรับการเพิ่ม Aspose.Zip.Xar.XarEntry รายการ

`Returns`

XarEntry

หลักฐานการเข้าสู่ระบบ

`Examples`

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

`Exceptions`

name’ is null.

source’ is null.

name’ is empty.

ไม่สามารถแก้ไขไฟล์ xar

`DeleteEntry(XarEntry)`

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

public XarArchive DeleteEntry(XarEntry entry)

`Parameters`

entry XarEntry

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

`Returns`

XarArchive

หลักฐานการเข้าสู่ระบบ

`Examples`

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

using (var archive = new XarArchive("archive.xar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries.FirstOrDefault());
    archive.Save(outputXarFile);
}

`Exceptions`

entry’ is null.

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

`Remarks`

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

`Exceptions`

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

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

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

NotSupportedException

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

เส้นผ่านศูนย์กลางเป็นเส้นผ่าศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลางเส้นผ่านศูนย์กลาง

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

InvalidDataException

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

`Save(ลวด, XarSaveOptions)`

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

public void Save(string destinationFileName, XarSaveOptions saveOptions = null)

`Parameters`

destinationFileName string

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

saveOptions XarSaveOptions

ตัวเลือกในการบันทึกไฟล์ xar ด้วย

`Exceptions`

destinationFileName’ is null.

ไม่สามารถแก้ไขไฟล์ xar

`Save(กระแส, XarSaveOptions)`

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

public void Save(Stream output, XarSaveOptions saveOptions = null)

`Parameters`

output Stream

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

saveOptions XarSaveOptions

ตัวเลือกในการบันทึกไฟล์ xar ด้วย

`Exceptions`

output’ is null.

output’Is not writable/readable or not seekable.