Class ZArchive

Class ZArchive

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

คลาสนี้แสดงให้เห็นถึงไฟล์ไฟล์ Z (บีบอัด) ใช้ไฟล์นี้เพื่อประกอบหรือสกัดไฟล์ Z

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object ZArchive

Implements

IArchive , IDisposable , IArchiveFileEntry

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

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

Remarks

ดู https://docs.fileformat.com/compression/z/

Constructors

เฟอร์นิเจอร์()

เปิดตัวตัวตัวอย่างใหม่ของคลาส Aspose.Zip.ZArchive ที่เตรียมพร้อมสําหรับการบีบอัด

public ZArchive()

เฟอร์นิเจอร์(แหล่งจ่ายไฟ ZArchiveLoadOptions)

เปิดตัวตัวตัวอย่างใหม่ของคลาส Aspose.Zip.ZArchive ที่เตรียมพร้อมสําหรับการบีบอัด

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

Parameters

source Stream

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

loadOptions ZArchiveLoadOptions

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

Remarks

เครื่องก่อสร้างนี้ไม่ลดลง ดู Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) วิธีการลดลง

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

เฟอร์นิเจอร์(ลวด, ZArchiveLoadOptions)

เปิดตัวตัวตัวอย่างใหม่ของคลาส Aspose.Zip.ZArchive ที่เตรียมพร้อมสําหรับการบีบอัด

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Parameters

path string

ทางไปสู่แหล่งข้อมูลของเอกสาร

loadOptions ZArchiveLoadOptions

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

Remarks

เครื่องก่อสร้างนี้ไม่ลดลง ดู Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) วิธีการลดลง

Exceptions

ArgumentNullException

path’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

Methods

Dispose()

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

public void Dispose()

Dispose(บอล)

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

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

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

Extract(Stream)

Extracts Z Archive to a Stream

public void Extract(Stream destination)

Parameters

destination Stream

กระแสสําหรับการจัดเก็บข้อมูลที่ซับซ้อน

Examples

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
    {
        using (var archive = new ZArchive(zFile))
        {
            archive.Extract(extractedFile);
        }
    }
}

Exceptions

InvalidDataException

ข้อมูลไม่สามารถบีบอัด

Extract(FileInfo)

extract Z archive ไปยังไฟล์

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo สําหรับการจัดเก็บข้อมูลที่ซับซ้อน

Examples

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

Exceptions

SecurityException

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

ArgumentException

เส้นทางไฟล์นั้นว่างเปล่าหรือมีพื้นที่สีขาวเท่านั้น

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

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

InvalidDataException

ข้อมูลไม่สามารถบีบอัด

Extract(รั้ว)

Extracts Z archive to a file by path

public FileInfo Extract(string path)

Parameters

path string

วิธีการเข้าสู่ไฟล์ซึ่งจะจัดเก็บข้อมูลที่ซับซ้อน

Returns

FileInfo

ข้อมูลของไฟล์ที่สกัด

Examples

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract("extracted.bin");
    }
}

Exceptions

ArgumentNullException

path’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

InvalidDataException

ข้อมูลไม่สามารถบีบอัด

ExtractToDirectory(รั้ว)

สารสกัดเนื้อหาของเอกสารไปยังไดเรกทอรีที่ให้

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

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

Remarks

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

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).

IOException

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

Save(แหล่งจ่ายไฟ ZArchiveSaveOptions)

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

public void Save(Stream output, ZArchiveSaveOptions settings = null)

Parameters

output Stream

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

settings ZArchiveSaveOptions

การตั้งค่าตัวเลือกสําหรับองค์ประกอบเอกสาร

Examples

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

Remarks

จําเป็นต้องมองหา

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(ลวด, ZArchiveSaveOptions)

เก็บไฟล์ Z ไปยังไฟล์ปลายทางที่ให้

public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)

Parameters

destinationFileName string

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

settings ZArchiveSaveOptions

การตั้งค่าตัวเลือกสําหรับองค์ประกอบเอกสาร

Examples

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

SetSource(Stream)

ใส่เนื้อหาที่จะถูกบีบอัดภายในเอกสาร

public void SetSource(Stream source)

Parameters

source Stream

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

Examples

using (var archive = new ZArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.Z");
}

SetSource(FileInfo)

ใส่เนื้อหาที่จะถูกบีบอัดภายในเอกสาร

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo ซึ่งจะเปิดเป็นแหล่งป้อน

Examples

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

Exceptions

SecurityException

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

ArgumentException

เส้นทางไฟล์นั้นว่างเปล่าหรือมีพื้นที่สีขาวเท่านั้น

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

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

SetSource(รั้ว)

ใส่เนื้อหาที่จะถูกบีบอัดภายในเอกสาร

public void SetSource(string sourcePath)

Parameters

sourcePath string

เส้นทางไปยังไฟล์ซึ่งจะเปิดเป็นการไหลเข้า

Examples

using (var archive = new ZArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("data.bin.Z");
}

Exceptions

ArgumentNullException

sourcePath’ is null or empty string.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 แบบไทย