Class ZArchive
Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)
כיתה זו מייצגת קובץ ארכיון Z (דחוס). השתמשו בה כדי להרכיב או לחלץ ארכיונים מסוג Z.
public class ZArchive : IArchive, IDisposable, IArchiveFileEntry
ירושה
מממש
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) לפענוח.
חריגות
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 תווים.
הקובץ בpath
מכיל נקודתיים (:) באמצע המחרוזת.
הקובץ לא נמצא.
הנתיב המצויין אינו חוקי, כגון כאשר הוא נמצא בכונן שאינו ממופה.
הקובץ כבר פתוח.
שיטות
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);
}
}
}
חריגות
הנתונים לא יכולים להתפענח.
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
.
נתיב הקובץ ריק או מכיל רק רווחים.
הקובץ לא נמצא.
הנתיב לקובץ הוא רק לקריאה או שהוא תיקייה.
fileInfo
הוא null.
הנתיב המצויין אינו חוקי, כגון כאשר הוא נמצא בכונן שאינו ממופה.
הקובץ כבר פתוח.
הנתונים לא יכולים להתפענח.
Extract(string)
מחלץ ארכיון Z לקובץ לפי נתיב.
public FileInfo Extract(string path)
פרמטרים
path
string
נתיב לקובץ שיאחסן נתונים מפוענחים.
מחזיר
מידע על הקובץ המופק.
דוגמאות
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}
חריגות
path
הוא null.
לקרוא אין את ההרשאה הנדרשת לגישה.
path
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
גישה לקובץ path
נדחתה.
path
, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, נתיבים חייבים להיות פחות מ-248 תווים, ושמות קבצים חייבים להיות פחות מ-260 תווים.
הקובץ בpath
מכיל נקודתיים (:) באמצע המחרוזת.
הנתונים לא יכולים להתפענח.
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
.
נתיב הקובץ ריק או מכיל רק רווחים.
הקובץ לא נמצא.
הנתיב לקובץ הוא רק לקריאה או שהוא תיקייה.
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 תווים.
הקובץ בsourcePath
מכיל נקודתיים (:) באמצע המחרוזת.