Class ZArchive

Class ZArchive

Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)

כיתה זו מייצגת קובץ ארכיון Z (דחוס). השתמשו בה כדי להרכיב או לחלץ ארכיונים מסוג Z.

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

ירושה

objectZArchive

מממש

IArchive, IDisposable, IArchiveFileEntry

חברים שהורשו

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

הערות

ראו https://docs.fileformat.com/compression/z/

בונים

ZArchive()

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

public ZArchive()

ZArchive(Stream, ZArchiveLoadOptions)

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

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

פרמטרים

source Stream

מקור הארכיון.

loadOptions ZArchiveLoadOptions

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

הערות

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

חריגות

ArgumentException

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

ArgumentNullException

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) לפענוח.

חריגות

ArgumentNullException

path הוא null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

שיטות

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"));
    }
}

חריגות

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo הוא null.

DirectoryNotFoundException

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

IOException

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

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");
    }
}

חריגות

ArgumentNullException

path הוא null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

InvalidDataException

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

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

פרמטרים

destinationDirectory string

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

הערות

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

חריגות

ArgumentNullException

destinationDirectory הוא null.

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

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

IOException

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

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 חייב להיות ניתן לחיפוש.

חריגות

ArgumentException

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

ArgumentNullException

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");
}

חריגות

ArgumentNullException

destinationFileName הוא null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

הקובץ ב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");
}

חריגות

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo הוא null.

DirectoryNotFoundException

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

IOException

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

SetSource(string)

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

public void SetSource(string sourcePath)

פרמטרים

sourcePath string

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

דוגמאות

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

חריגות

ArgumentNullException

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

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 Ελληνικά