Class ZArchive

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

source הוא null.

ZArchive(string, ZArchiveLoadOptions)

מאתחל מופע חדש של כיתה Aspose.Zip.Z.ZArchive המוכן לפענוח.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

פרמטרים

path string

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

loadOptions ZArchiveLoadOptions

האפשרויות לטעינת הארכיון.

הערות

בונה זה אינו מפענח. ראו את השיטה Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) לפענוח.

חריגות

path הוא null.

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

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

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

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

DirectoryNotFoundException

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

FileNotFoundException

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

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

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

שיטות

Dispose()

מבצע משימות המוגדרות על ידי היישום הקשורות לשחרור, שחרור או איפוס של משאבים שאינם מנוהלים.

public void Dispose()

Dispose(bool)

מבצע משימות המוגדרות על ידי היישום הקשורות לשחרור, שחרור או איפוס של משאבים שאינם מנוהלים.

protected virtual void Dispose(bool disposing)

פרמטרים

disposing bool

אם יש לשחרר את המשאבים המנוהלים.

Extract(Stream)

מחלץ ארכיון Z לזרם.

public void Extract(Stream destination)

פרמטרים

destination Stream

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

דוגמאות

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

חריגות

InvalidDataException

הנתונים לא יכולים להתפענח.

Extract(FileInfo)

מחלץ ארכיון Z לקובץ.

public void Extract(FileInfo fileInfo)

פרמטרים

fileInfo FileInfo

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

דוגמאות

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

חריגות

לקרוא אין את ההרשאה הנדרשת לפתוח את fileInfo.

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

FileNotFoundException

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

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

DirectoryNotFoundException

fileInfo הוא null.

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

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

InvalidDataException

הנתונים לא יכולים להתפענח.

Extract(string)

מחלץ ארכיון Z לקובץ לפי נתיב.

public FileInfo Extract(string path)

פרמטרים

path string

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

מחזיר

FileInfo

מידע על הקובץ המופק.

דוגמאות

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

חריגות

path הוא null.

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

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

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

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

InvalidDataException

הנתונים לא יכולים להתפענח.

ExtractToDirectory(string)

מחלץ את תוכן הארכיון לתיקייה שסופקה.

public void ExtractToDirectory(string destinationDirectory)

פרמטרים

destinationDirectory string

הנתיב לתיקייה שבה יונחו הקבצים המופקים.

הערות

אם התיקייה אינה קיימת, היא תיווצר.

חריגות

destinationDirectory הוא null.

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

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

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

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

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

Save(Stream, ZArchiveSaveOptions)

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

public void Save(Stream output, ZArchiveSaveOptions settings = null)

פרמטרים

output Stream

זרם יעד.

settings ZArchiveSaveOptions

הגדרות אופציונליות להרכבת הארכיון.

דוגמאות

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

הערות

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

חריגות

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

output הוא null.

Save(string, ZArchiveSaveOptions)

שומר ארכיון Z לקובץ יעד שסופק.

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

פרמטרים

destinationFileName string

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

settings ZArchiveSaveOptions

הגדרות אופציונליות להרכבת הארכיון.

דוגמאות

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

חריגות

destinationFileName הוא null.

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

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

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

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

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

SetSource(Stream)

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

public void SetSource(Stream source)

פרמטרים

source Stream

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

דוגמאות

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

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

פרמטרים

fileInfo FileInfo

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

דוגמאות

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

חריגות

לקרוא אין את ההרשאה הנדרשת לפתוח את fileInfo.

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

FileNotFoundException

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

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

DirectoryNotFoundException

fileInfo הוא null.

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

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

SetSource(string)

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

public void SetSource(string sourcePath)

פרמטרים

sourcePath string

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

דוגמאות

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

חריגות

sourcePath הוא null או מחרוזת ריקה.

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

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

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

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