Class LzipArchive
Namespace: Aspose.Zip.Lzip
Assembly: Aspose.Zip.dll (25.1.0)
כיתה זו מייצגת קובץ ארכיון Lzip. השתמש בה כדי להרכיב או לחלץ ארכיוני Lzip.
public class LzipArchive : 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()
קונסטרוקטורים
LzipArchive(LzipArchiveSettings)
מאתחל מופע חדש של Aspose.Zip.Lzip.LzipArchive.
public LzipArchive(LzipArchiveSettings settings = null)
פרמטרים
settings
LzipArchiveSettings
הגדרה של ארכיון lzip מסוים עם הגדרת גודל המילון.
LzipArchive(Stream)
מאתחל מופע חדש של כיתה Aspose.Zip.Lzip.LzipArchive המוכן לדחיסה.
public LzipArchive(Stream sourceStream)
פרמטרים
sourceStream
Stream
מקור הארכיון.
הערות
קונסטרוקטור זה אינו דוחס. ראה את השיטה Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) לדחיסה.
חריגות
sourceStream
אינו ניתן לחיפוש.
sourceStream
הוא null.
כותרות אינן תואמות לסוג הארכיון lzip.
LzipArchive(string)
מאתחל מופע חדש של כיתה Aspose.Zip.Lzip.LzipArchive המוכן לדחיסה.
public LzipArchive(string path)
פרמטרים
path
string
נתיב למקור הארכיון.
דוגמאות
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzipArchive(sourceLzipFile))
{
archive.Extract(extractedFile);
}
}
הערות
קונסטרוקטור זה אינו דוחס. ראה את השיטה Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) לדחיסה.
חריגות
path
הוא null.
המבצע אינו מחזיק בהרשאה הנדרשת לגישה.
הpath
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
גישה לקובץ path
נדחתה.
הpath
שנבחר, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, נתיבים חייבים להיות פחות מ-248 תווים, ושמות קבצים חייבים להיות פחות מ-260 תווים.
הקובץ בpath
מכיל נקודתיים (:) באמצע המחרוזת.
הקובץ לא נמצא.
הנתיב שנבחר אינו חוקי, כגון הימצאותו בכונן לא ממופה.
הקובץ כבר פתוח.
כותרות אינן תואמות לסוג הארכיון lzip.
מאפיינים
Settings
מקבל את ההגדרה של ארכיון lzip מסוים.
public LzipArchiveSettings Settings { get; }
ערך המאפיין
שיטות
Dispose()
מבצע משימות מוגדרות על ידי היישום הקשורות לשחרור, שחרור או איפוס של משאבים לא מנוהלים.
public void Dispose()
Dispose(bool)
מבצע משימות מוגדרות על ידי היישום הקשורות לשחרור, שחרור או איפוס של משאבים לא מנוהלים.
protected virtual void Dispose(bool disposing)
פרמטרים
disposing
bool
האם יש לשחרר משאבים מנוהלים.
Extract(Stream)
חולץ ארכיון lzip לזרם.
public void Extract(Stream destination)
פרמטרים
destination
Stream
זרם לאחסון נתונים לא דחוסים.
דוגמאות
using (FileStream sourceLzipFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzipArchive(sourceLzipFile))
{
archive.Extract(extractedFile);
}
}
}
חריגות
כותרות הארכיון ומידע השירות לא נקראו.
שגיאה בנתונים בכותרת או ב-checksum.
זרם היעד הוא null.
זרם היעד אינו תומך בכתיבה.
Extract(FileInfo)
חולץ ארכיון lzip לקובץ.
public void Extract(FileInfo fileInfo)
פרמטרים
fileInfo
FileInfo
FileInfo לאחסון נתונים לא דחוסים.
דוגמאות
using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzipArchive(lzipFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
חריגות
כותרות הארכיון ומידע השירות לא נקראו.
המבצע אינו מחזיק בהרשאה הנדרשת לפתוח את fileInfo
.
נתיב הקובץ ריק או מכיל רק רווחים.
הקובץ לא נמצא.
הנתיב לקובץ הוא רק לקריאה או שהוא תיקייה.
fileInfo
הוא null.
הנתיב שנבחר אינו חוקי, כגון הימצאותו בכונן לא ממופה.
הקובץ כבר פתוח.
Extract(string)
חולץ ארכיון lzip לקובץ לפי נתיב.
public void Extract(string path)
פרמטרים
path
string
נתיב לקובץ שיאחסן נתונים לא דחוסים.
דוגמאות
using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzipArchive(xzFile))
{
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)
שומר את ארכיון lzip לזרם שניתן.
public void Save(Stream outputStream)
פרמטרים
outputStream
Stream
זרם היעד.
דוגמאות
using (FileStream lzFile = File.Open("archive.lz", FileMode.Create))
{
using (var archive = new LzipArchive())
{
archive.SetSource("data.bin");
archive.Save(lzFile);
}
}
הערות
outputStream
חייב להיות ניתן לחיפוש.
חריגות
outputStream
אינו תומך בחיפוש.
outputStream
הוא null.
Save(string)
שומר את ארכיון lzip לקובץ היעד שניתן.
public void Save(string destinationFileName)
פרמטרים
destinationFileName
string
הנתיב של הארכיון שיתוצר. אם שם הקובץ שנבחר מצביע על קובץ קיים, הוא יוחלף.
דוגמאות
using (var archive = new LzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.lz");
}
חריגות
destinationFileName
הוא null.
המבצע אינו מחזיק בהרשאה הנדרשת לגישה.
הdestinationFileName
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
גישה לקובץ destinationFileName
נדחתה.
הdestinationFileName
שנבחר, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, נתיבים חייבים להיות פחות מ-248 תווים, ושמות קבצים חייבים להיות פחות מ-260 תווים.
הקובץ בdestinationFileName
מכיל נקודתיים (:) באמצע המחרוזת.
Save(FileInfo)
שומר את ארכיון lzip לקובץ היעד שניתן.
public void Save(FileInfo destination)
פרמטרים
destination
FileInfo
FileInfo שיפתח כזרם יעד.
דוגמאות
using (var archive = new LzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lz"));
}
חריגות
המבצע אינו מחזיק בהרשאה הנדרשת לפתוח את destination
.
נתיב הקובץ ריק או מכיל רק רווחים.
הקובץ לא נמצא.
הנתיב לקובץ הוא רק לקריאה או שהוא תיקייה.
destination
הוא null.
הנתיב שנבחר אינו חוקי, כגון הימצאותו בכונן לא ממופה.
הקובץ כבר פתוח.
SetSource(Stream)
מגדיר את התוכן שידחס בתוך הארכיון.
public void SetSource(Stream source)
פרמטרים
source
Stream
זרם הקלט עבור הארכיון.
דוגמאות
using (var archive = new LzipArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lz");
}
חריגות
זרם הsource
אינו ניתן לחיפוש.
SetSource(FileInfo)
מגדיר את התוכן שידחס בתוך הארכיון.
public void SetSource(FileInfo fileInfo)
פרמטרים
fileInfo
FileInfo
FileInfo שיפתח כזרם קלט.
דוגמאות
using (var archive = new LzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lz");
}
חריגות
המבצע אינו מחזיק בהרשאה הנדרשת לפתוח את fileInfo
.
נתיב הקובץ ריק או מכיל רק רווחים.
הקובץ לא נמצא.
הנתיב לקובץ הוא רק לקריאה או שהוא תיקייה.
fileInfo
הוא null.
הנתיב שנבחר אינו חוקי, כגון הימצאותו בכונן לא ממופה.
הקובץ כבר פתוח.
SetSource(string)
מגדיר את התוכן שידחס בתוך הארכיון.
public void SetSource(string path)
פרמטרים
path
string
נתיב לקובץ שידחס.
דוגמאות
using (var archive = new LzipArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz");
}
חריגות
path
הוא null.
המבצע אינו מחזיק בהרשאה הנדרשת לגישה.
הpath
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
גישה לקובץ path
נדחתה.
הpath
שנבחר, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, נתיבים חייבים להיות פחות מ-248 תווים, ושמות קבצים חייבים להיות פחות מ-260 תווים.
הקובץ בpath
מכיל נקודתיים (:) באמצע המחרוזת.