Class ZstandardArchive

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

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

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

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

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

`Methods`

`Dispose()`

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

public void Dispose()

`Dispose(บอล)`

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

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

`Extract(Stream)`

extract the archive to the stream ที่ให้

public void Extract(Stream destination)

`Parameters`

destination Stream

จุดหมายปลายทาง Stream. ต้องการเขียนได้

`Examples`

using (var archive = new GzipArchive("archive.zst"))
{
     archive.Extract(httpResponseStream);
}

`Exceptions`

destination’ does not support writing.

`Extract(รั้ว)`

extract the archive to the file by path

public FileInfo Extract(string path)

`Parameters`

path string

เส้นทางไปยังไฟล์เป้าหมาย หากไฟล์มีอยู่แล้วมันจะถูกเขียนเกินไป

`Returns`

FileInfo

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

`Exceptions`

path’ is null.

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

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

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

`ExtractToDirectory(รั้ว)`

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

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

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

`Remarks`

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

`Exceptions`

destinationDirectory’ is null.

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

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

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

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

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

`Open()`

เปิดเอกสารสําหรับการสกัดและให้การไหลที่มีเนื้อหาเอกสาร

public Stream Open()

`Returns`

Stream

กระแสที่นําเสนอเนื้อหาของเอกสาร

`Examples`

extract the archive and copies the extracted content to file stream

using (var archive = new ZstandardArchive("archive.zst"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 &lt; (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

คุณสามารถใช้วิธีการ Stream.CopyTo สําหรับ .NET 4.0 และสูงกว่า: unpacked.Kopy To(สกัด)

`Remarks`

Read from the stream to get the original content of a file ดูส่วนตัวอย่าง

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

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

public void Save(Stream outputStream, ZstandardSaveOptions settings = null)

`Parameters`

outputStream Stream

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

settings ZstandardSaveOptions

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

`Examples`

เขียนข้อมูลที่บีบอัดไปยัง HTTP response stream

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

`Remarks`

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

`Exceptions`

InvalidOperationException

outputStream’ is not writable.

แหล่งที่มาไม่ได้จัดหา

`Save(ลวด, ZstandardSaveOptions)`

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

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

`Parameters`

destinationFileName string

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

settings ZstandardSaveOptions

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

`Examples`

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.zst");
}

`Exceptions`

destinationFileName’ is null.

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

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

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

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

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

`Save(FileInfo, ZstandardSaveOptions)`

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

public void Save(FileInfo destination, ZstandardSaveOptions settings = null)

`Parameters`

destination FileInfo

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

settings ZstandardSaveOptions

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

`Examples`

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

`Exceptions`

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

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

FileNotFoundException

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

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

DirectoryNotFoundException

destination’ is null.

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

IOException

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

`SetSource(Stream)`

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

public void SetSource(Stream source)

`Parameters`

source Stream

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

`Examples`

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

`SetSource(FileInfo)`

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

public void SetSource(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

การอ้างอิงถึงไฟล์ที่จะถูกบีบอัด

`Examples`

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

`SetSource(รั้ว)`

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

public void SetSource(string path)

`Parameters`

path string

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

`Examples`

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

`Exceptions`

path’ is null.

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

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