Class ZstandardArchive

path เป็น null

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

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

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

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

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

วิธีการ

Dispose()

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

public void Dispose()

Dispose(bool)

protected virtual void Dispose(bool disposing)

พารามิเตอร์

disposing bool

ว่าทรัพยากรที่จัดการควรจะถูกปล่อยหรือไม่

Extract(Stream)

แตกแอปซอร์ดไปยังสตรีมที่ให้ไว้

public void Extract(Stream destination)

พารามิเตอร์

destination Stream

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

ตัวอย่าง

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

ข้อยกเว้น

destination ไม่รองรับการเขียน

Extract(string)

แตกแอปซอร์ดไปยังไฟล์ตามเส้นทาง

public FileInfo Extract(string path)

พารามิเตอร์

path string

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

คืนค่า

FileInfo

ข้อมูลของไฟล์ที่ถูกแตกออก

ข้อยกเว้น

path เป็น null

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

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

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

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

ExtractToDirectory(string)

แตกเนื้อหาของแอปซอร์ดไปยังไดเรกทอรีที่ให้ไว้

public void ExtractToDirectory(string destinationDirectory)

พารามิเตอร์

destinationDirectory string

เส้นทางไปยังไดเรกทอรีที่จะวางไฟล์ที่ถูกแตกออก

หมายเหตุ

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

ข้อยกเว้น

destinationDirectory เป็น null

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

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

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

IOException

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

Open()

เปิดแอปซอร์ดสำหรับการแตกและให้สตรีมที่มีเนื้อหาแอปซอร์ด

public Stream Open()

คืนค่า

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.CopyTo(extracted);`

หมายเหตุ

อ่านจากสตรีมเพื่อให้ได้เนื้อหาต้นฉบับของไฟล์ ดูส่วนตัวอย่าง

Save(Stream, ZstandardSaveOptions)

บันทึกแอปซอร์ดไปยังสตรีมที่ให้ไว้

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

พารามิเตอร์

outputStream Stream

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

settings ZstandardSaveOptions

การตั้งค่าเพิ่มเติมสำหรับการสร้างแอปซอร์ด

ตัวอย่าง

เขียนข้อมูลที่ถูกบีบอัดไปยังสตรีมการตอบสนอง http

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

หมายเหตุ

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

ข้อยกเว้น

InvalidOperationException

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

แหล่งข้อมูลยังไม่ได้รับการจัดเตรียม

Save(string, ZstandardSaveOptions)

บันทึกแอปซอร์ดไปยังไฟล์ปลายทางที่ให้ไว้

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

พารามิเตอร์

destinationFileName string

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

settings ZstandardSaveOptions

การตั้งค่าเพิ่มเติมสำหรับการสร้างแอปซอร์ด

ตัวอย่าง

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

ข้อยกเว้น

destinationFileName เป็น null

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

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

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

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

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

Save(FileInfo, ZstandardSaveOptions)

บันทึกแอปซอร์ดไปยังไฟล์ปลายทางที่ให้ไว้

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

พารามิเตอร์

destination FileInfo

FileInfo ที่จะถูกเปิดเป็นสตรีมปลายทาง

settings ZstandardSaveOptions

การตั้งค่าเพิ่มเติมสำหรับการสร้างแอปซอร์ด

ตัวอย่าง

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

ข้อยกเว้น

ผู้เรียกไม่มีสิทธิ์ที่ต้องการในการเปิด destination

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

FileNotFoundException

ไม่พบไฟล์

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

DirectoryNotFoundException

destination เป็น null

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

IOException

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

SetSource(Stream)

ตั้งค่าเนื้อหาที่จะถูกบีบอัดภายในแอปซอร์ด

public void SetSource(Stream source)

พารามิเตอร์

source Stream

สตรีมข้อมูลนำเข้าสำหรับแอปซอร์ด

ตัวอย่าง

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

SetSource(FileInfo)

ตั้งค่าเนื้อหาที่จะถูกบีบอัดภายในแอปซอร์ด

public void SetSource(FileInfo fileInfo)

พารามิเตอร์

fileInfo FileInfo

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

ตัวอย่าง

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

SetSource(string)

ตั้งค่าเนื้อหาที่จะถูกบีบอัดภายในแอปซอร์ด

public void SetSource(string path)

พารามิเตอร์

path string

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

ตัวอย่าง

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

ข้อยกเว้น

path เป็น null

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

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

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