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.

הנתיב, שם הקובץ או שניהם חורגים מהאורך המרבי שהוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, הנתיבים חייבים להיות פחות מ-248 תווים ושמות הקבצים חייבים להיות פחות מ-260 תווים.

לקרוא לא יש את ההרשאה הנדרשת לגישה לתיקייה הקיימת.

אם התיקייה אינה קיימת, הנתיב מכיל תו נקודתיים (:) שאינו חלק מתווית כונן (“C:").

destinationDirectory הוא מיתר באורך אפס, מכיל רק רווחים, או מכיל תו או יותר לא חוקיים. ניתן לבדוק תווים לא חוקיים באמצעות המתודה System.IO.Path.GetInvalidPathChars. -או- הנתיב מקדים, או מכיל, רק תו נקודתיים (:).

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 נדחתה.