Class XzArchive

source אינו ניתן לחיפוש.

source הוא null.

XzArchive(string)

מאתחל מופע חדש של הכיתה Aspose.Zip.Xz.XzArchive המוכן לדחיסה.

public XzArchive(string path)

פרמטרים

path string

נתיב למקור הארכיון.

הערות

בונה זה אינו מבצע דחיסה. ראה את השיטה Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) לדחיסה.

חריגים

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)

מוציא ארכיון xz לזרם.

public void Extract(Stream destination)

פרמטרים

destination Stream

זרם לאחסון נתונים מדחוסים.

דוגמאות

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

חריגים

כותרות הארכיון ומידע השירות לא נקראו.

Extract(FileInfo)

מוציא ארכיון xz לקובץ.

public void Extract(FileInfo fileInfo)

פרמטרים

fileInfo FileInfo

FileInfo לאחסון נתונים מדחוסים.

דוגמאות

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

חריגים

InvalidOperationException

כותרות הארכיון ומידע השירות לא נקראו.

המבצע אינו מחזיק בהרשאה הנדרשת לפתיחת הfileInfo.

נתיב הקובץ ריק או מכיל רק רווחים.

הקובץ לא נמצא.

הנתיב לקובץ הוא רק לקריאה או שהוא תיקייה.

fileInfo הוא null.

הנתיב שניתן אינו חוקי, כמו למשל כאשר הוא נמצא בכונן לא ממופה.

InvalidOperationException

הקובץ כבר פתוח.

Extract(string)

מוציא ארכיון xz לקובץ לפי נתיב.

public FileInfo Extract(string path)

פרמטרים

path string

נתיב לקובץ שיאחסן נתונים מדחוסים.

מחזיר

FileInfo

אינסטנציה של System.IO.FileInfo המכילה נתונים שהוצאו.

דוגמאות

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

חריגים

כותרות הארכיון ומידע השירות לא נקראו.

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. -או- הנתיב מקדים, או מכיל, רק תו נקודתיים (:).

התיקייה שצוינה על ידי הנתיב היא קובץ. -או- שם הרשת אינו ידוע.

Save(Stream)

שומר את ארכיון xz לזרם שניתן.

public void Save(Stream output)

פרמטרים

output Stream

זרם יעד.

דוגמאות

using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
    using (var archive = new XzArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(xzFile);
     }
}

הערות

output חייב להיות ניתן לחיפוש.

חריגים

output אינו תומך בחיפוש.

output הוא null.

Save(string)

שומר את ארכיון xz לקובץ היעד שניתן.

public void Save(string destinationFileName)

פרמטרים

destinationFileName string

הנתיב של הארכיון שיצור. אם שם הקובץ שניתן מצביע על קובץ קיים, הוא יוחלף.

דוגמאות

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

חריגים

destinationFileName הוא null.

המבצע אינו מחזיק בהרשאה הנדרשת לגישה.

הdestinationFileName ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.

גישה לקובץ destinationFileName נדחתה.

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

הקובץ בdestinationFileName מכיל נקודתיים (:) באמצע המחרוזת.

SetSource(Stream)

מגדיר את התוכן שידחס בתוך הארכיון.

public void SetSource(Stream source)

פרמטרים

source Stream

הזרם הקלט עבור הארכיון.

דוגמאות

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

חריגים

הזרם source אינו ניתן לחיפוש.

SetSource(FileInfo)

מגדיר את התוכן שידחס בתוך הארכיון.

public void SetSource(FileInfo fileInfo)

פרמטרים

fileInfo FileInfo

FileInfo שייפתח כזרם קלט.

דוגמאות

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

חריגים

המבצע אינו מחזיק בהרשאה הנדרשת לפתוח את הfileInfo.

נתיב הקובץ ריק או מכיל רק רווחים.

הקובץ לא נמצא.

הנתיב לקובץ הוא רק לקריאה או שהוא תיקייה.

fileInfo הוא null.

הנתיב שניתן אינו חוקי, כמו למשל כאשר הוא נמצא בכונן לא ממופה.

הקובץ כבר פתוח.

SetSource(string)

מגדיר את התוכן שידחס בתוך הארכיון.

public void SetSource(string sourcePath)

פרמטרים

sourcePath string

נתיב לקובץ שייפתח כזרם קלט.

דוגמאות

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

חריגים

sourcePath הוא null.

המבצע אינו מחזיק בהרשאה הנדרשת לגישה.

הsourcePath ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.

גישה לקובץ sourcePath נדחתה.

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