Class SnappyArchive

source ไม่สามารถค้นหาได้

source เป็นค่า null

SnappyArchive(string)

public SnappyArchive(string path)

พารามิเตอร์

path string

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

ตัวอย่าง

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

หมายเหตุ

ข้อยกเว้น

path เป็นค่า null

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง

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

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

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

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

ไม่พบไฟล์

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

InvalidOperationException

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

วิธีการ

Dispose()

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

public void Dispose()

Dispose(bool)

protected virtual void Dispose(bool disposing)

พารามิเตอร์

disposing bool

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

Extract(Stream)

แยกไฟล์เก็บข้อมูลแบบ snappy ไปยังสตรีม

public void Extract(Stream destination)

พารามิเตอร์

destination Stream

สตรีมสำหรับเก็บข้อมูลที่ถอดรหัส

ตัวอย่าง

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

ข้อยกเว้น

ไม่สามารถอ่านหัวข้อไฟล์เก็บข้อมูลและข้อมูลบริการได้

InvalidDataException

มีข้อผิดพลาดในข้อมูลในหัวข้อหรือ checksum

สตรีมปลายทางเป็นค่า null

InvalidOperationException

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

Extract(FileInfo)

แยกไฟล์เก็บข้อมูลแบบ snappy ไปยังไฟล์

public void Extract(FileInfo fileInfo)

พารามิเตอร์

fileInfo FileInfo

FileInfo สำหรับเก็บข้อมูลที่ถอดรหัส

ตัวอย่าง

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

ข้อยกเว้น

ไม่สามารถอ่านหัวข้อไฟล์เก็บข้อมูลและข้อมูลบริการได้

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเปิด fileInfo

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

ไม่พบไฟล์

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

fileInfo เป็นค่า null

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

InvalidOperationException

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

Extract(string)

แยกไฟล์เก็บข้อมูลแบบ snappy ไปยังไฟล์ตามเส้นทาง

public FileInfo Extract(string path)

พารามิเตอร์

path string

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

คืนค่า

FileInfo

อินสแตนซ์ System.IO.FileInfo ที่มีข้อมูลที่ถอดรหัส

ตัวอย่าง

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

ข้อยกเว้น

ไม่สามารถอ่านหัวข้อไฟล์เก็บข้อมูลและข้อมูลบริการได้

path เป็นค่า null

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง

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

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

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

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

พารามิเตอร์

destinationDirectory string

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

หมายเหตุ

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

ข้อยกเว้น

destinationDirectory เป็นค่า null

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

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

หากไดเรกทอรีไม่มีอยู่ เส้นทางมีอักขระโคลอน (:) ที่ไม่เป็นส่วนหนึ่งของป้ายไดรฟ์ (“C:")

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

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

Save(Stream)

บันทึกไฟล์เก็บข้อมูลแบบ snappy ไปยังสตรีมที่กำหนด

public void Save(Stream output)

พารามิเตอร์

output Stream

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

ตัวอย่าง

using (FileStream snappyFile = File.Open("archive.snappy", FileMode.Create))
{
    using (var archive = new SnappyArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(snappyFile);
     }
}

หมายเหตุ

output ต้องสามารถค้นหาได้

ข้อยกเว้น

output ไม่รองรับการค้นหา

output เป็นค่า null

Save(FileInfo)

บันทึกไฟล์เก็บข้อมูลแบบ snappy ไปยังไฟล์ปลายทางที่กำหนด

public void Save(FileInfo destination)

พารามิเตอร์

destination FileInfo

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

ตัวอย่าง

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

ข้อยกเว้น

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเปิด destination

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

ไม่พบไฟล์

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

destination เป็นค่า null

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

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

Save(string)

บันทึกไฟล์เก็บข้อมูลแบบ snappy ไปยังไฟล์ปลายทางที่กำหนด

public void Save(string destinationFileName)

พารามิเตอร์

destinationFileName string

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

ตัวอย่าง

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

ข้อยกเว้น

destinationFileName เป็นค่า null

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง

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

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

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

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

SetSource(Stream)

ตั้งค่าคอนเทนต์ที่จะถูกบีบอัดภายในไฟล์เก็บข้อมูล

public void SetSource(Stream source)

พารามิเตอร์

source Stream

สตรีมข้อมูลนำเข้าสำหรับไฟล์เก็บข้อมูล

ตัวอย่าง

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

ข้อยกเว้น

สตรีม source ไม่สามารถค้นหาได้

SetSource(FileInfo)

ตั้งค่าคอนเทนต์ที่จะถูกบีบอัดภายในไฟล์เก็บข้อมูล

public void SetSource(FileInfo fileInfo)

พารามิเตอร์

fileInfo FileInfo

FileInfo ที่จะเปิดเป็นสตรีมข้อมูลนำเข้า

ตัวอย่าง

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

ข้อยกเว้น

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเปิด fileInfo

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

ไม่พบไฟล์

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

fileInfo เป็นค่า null

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

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

SetSource(string)

ตั้งค่าคอนเทนต์ที่จะถูกบีบอัดภายในไฟล์เก็บข้อมูล

public void SetSource(string sourcePath)

พารามิเตอร์

sourcePath string

เส้นทางไปยังไฟล์ที่จะเปิดเป็นสตรีมข้อมูลนำเข้า

ตัวอย่าง

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

ข้อยกเว้น

sourcePath เป็นค่า null

ผู้เรียกไม่มีสิทธิ์ที่จำเป็นในการเข้าถึง

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

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

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