Class LzmaArchive
Namespace: Aspose.Zip.LZMA
Assembly: Aspose.Zip.dll (25.1.0)
כיתה זו מייצגת קובץ ארכיון LZMA. השתמש בה כדי להרכיב או לחלץ ארכיונים של LZMA.
public class LzmaArchive : 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()
בונים
LzmaArchive(LzmaArchiveSettings)
מאתחל מופע חדש של כיתת Aspose.Zip.LZMA.LzmaArchive ומרכיב את הארכיון בפורמט lzma.
public LzmaArchive(LzmaArchiveSettings settings = null)
פרמטרים
settings
LzmaArchiveSettings
סט של הגדרות עבור ארכיון lzma מסוים.
LzmaArchive(Stream)
מאתחל מופע חדש של כיתת Aspose.Zip.LZMA.LzmaArchive המוכן לדחיסה.
public LzmaArchive(Stream source)
פרמטרים
source
Stream
מקור הארכיון.
הערות
בונה זה אינו מדחס. ראה את המתודה Aspose.Zip.LZMA.LzmaArchive.Extract(System.IO.Stream) לדחיסה.
חריגים
source
אינו ניתן לחיפוש.
source
הוא null.
LzmaArchive(string)
מאתחל מופע חדש של כיתת Aspose.Zip.LZMA.LzmaArchive המוכן לדחיסה.
public LzmaArchive(string path)
פרמטרים
path
string
נתיב למקור הארכיון.
דוגמאות
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzmaArchive(sourceLzmaFile))
{
archive.Extract(extractedFile);
}
}
הערות
בונה זה אינו מדחס. ראה את המתודה Aspose.Zip.LZMA.LzmaArchive.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)
מחלץ ארכיון lzma לזרם.
public void Extract(Stream destination)
פרמטרים
destination
Stream
זרם לאחסון נתונים מדחוסים.
דוגמאות
using (FileStream sourceLzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzmaArchive(sourceLzmaFile))
{
archive.Extract(extractedFile);
}
}
}
חריגים
כותרות הארכיון ומידע שירות לא נקראו.
הארכיון פגום.
זרם היעד הוא null.
זרם היעד אינו תומך בכתיבה.
Extract(FileInfo)
מחלץ ארכיון lzma לקובץ.
public void Extract(FileInfo fileInfo)
פרמטרים
fileInfo
FileInfo
FileInfo לאחסון נתונים מדחוסים.
דוגמאות
using (FileStream lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzmaArchive(lzmaFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
חריגים
כותרות הארכיון ומידע שירות לא נקראו.
לקרוא אין את ההרשאה הנדרשת לפתוח את הfileInfo
.
נתיב הקובץ ריק או מכיל רק רווחים.
הקובץ לא נמצא.
הנתיב לקובץ הוא קובץ קריאה בלבד או תיקיה.
fileInfo
הוא null.
הנתיב שנבחר אינו חוקי, כמו למשל שהוא נמצא בדרייב לא ממופה.
הקובץ כבר פתוח.
הארכיון פגום.
Extract(string)
מחלץ ארכיון lzma לקובץ לפי נתיב.
public void Extract(string path)
פרמטרים
path
string
נתיב לקובץ שיאחסן נתונים מדחוסים.
דוגמאות
using (FileStream lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzmaArchive(lzmaFile))
{
archive.Extract("extracted.bin");
}
}
חריגים
כותרות הארכיון ומידע שירות לא נקראו.
path
הוא null.
לקרוא אין את ההרשאה הנדרשת לגישה.
הpath
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
הגישה לקובץ path
נדחתה.
הpath
, שם הקובץ, או שניהם חורגים מהמגבלה המקסימלית המוגדרת על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, נתיבים חייבים להיות פחות מ-248 תווים, ושמות קבצים חייבים להיות פחות מ-260 תווים.
הקובץ בpath
מכיל נקודתיים (:) באמצע המחרוזת.
הארכיון פגום.
ExtractToDirectory(string)
מחלץ את תוכן הארכיון לתיקיה שניתנה.
public void ExtractToDirectory(string destinationDirectory)
פרמטרים
destinationDirectory
string
הנתיב לתיקיה שבה יונחו הקבצים שהוצאו.
הערות
אם התיקיה אינה קיימת, היא תיווצר.
חריגים
destinationDirectory
הוא null.
הpath
, שם הקובץ, או שניהם חורגים מהמגבלה המקסימלית המוגדרת על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, נתיבים חייבים להיות פחות מ-248 תווים ושמות קבצים חייבים להיות פחות מ-260 תווים.
לקרוא אין את ההרשאה הנדרשת לגישה לתיקיה הקיימת.
אם התיקיה אינה קיימת, הנתיב מכיל תו נקודתיים (:) שאינו חלק מתווית דרייב (“C:").
destinationDirectory
הוא מחרוזת באורך אפס, מכילה רק רווחים, או מכילה תו אחד או יותר לא חוקיים. ניתן לבדוק תווים לא חוקיים באמצעות המתודה System.IO.Path.GetInvalidPathChars.
-או- הנתיב מקדים, או מכיל, רק תו נקודתיים (:).
התיקיה שנבחרה על ידי הנתיב היא קובץ. -או- שם הרשת אינו ידוע.
הארכיון פגום.
Save(Stream)
שומר את הארכיון lzma לזרם שניתן.
public void Save(Stream output)
פרמטרים
output
Stream
זרם היעד.
דוגמאות
using (FileStream lzmaFile = File.Open("archive.lzma", FileMode.Create))
{
using (var archive = new LzmaArchive())
{
archive.SetSource("data.bin");
archive.Save(lzmaFile);
}
}
הערות
output
חייב להיות ניתן לחיפוש.
חריגים
output
אינו תומך בחיפוש.
output
הוא null.
Save(FileInfo)
שומר את הארכיון lzma לקובץ היעד שניתן.
public void Save(FileInfo destination)
פרמטרים
destination
FileInfo
FileInfo שייפתח כזרם היעד.
דוגמאות
using (var archive = new LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lzma"));
}
חריגים
לקרוא אין את ההרשאה הנדרשת לפתוח את הdestination
.
נתיב הקובץ ריק או מכיל רק רווחים.
הקובץ לא נמצא.
הנתיב לקובץ הוא קובץ קריאה בלבד או תיקיה.
destination
הוא null.
הנתיב שנבחר אינו חוקי, כמו למשל שהוא נמצא בדרייב לא ממופה.
הקובץ כבר פתוח.
Save(string)
שומר את הארכיון lzma לקובץ היעד שניתן.
public void Save(string destinationFileName)
פרמטרים
destinationFileName
string
הנתיב של הארכיון שיתווסף. אם שם הקובץ שנבחר מצביע על קובץ קיים, הוא יוחלף.
דוגמאות
using (var archive = new LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.lzma");
}
חריגים
destinationFileName
הוא null.
לקרוא אין את ההרשאה הנדרשת לגישה.
הdestinationFileName
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
הגישה לקובץ destinationFileName
נדחתה.
הdestinationFileName
, שם הקובץ, או שניהם חורגים מהמגבלה המקסימלית המוגדרת על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, נתיבים חייבים להיות פחות מ-248 תווים, ושמות קבצים חייבים להיות פחות מ-260 תווים.
הקובץ בdestinationFileName
מכיל נקודתיים (:) באמצע המחרוזת.
SetSource(Stream)
מגדיר את התוכן שידחס בתוך הארכיון.
public void SetSource(Stream source)
פרמטרים
source
Stream
זרם הקלט עבור הארכיון.
דוגמאות
using (var archive = new LzmaArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lzma");
}
חריגים
זרם הsource
אינו ניתן לחיפוש.
SetSource(FileInfo)
מגדיר את התוכן שידחס בתוך הארכיון.
public void SetSource(FileInfo fileInfo)
פרמטרים
fileInfo
FileInfo
FileInfo שייפתח כזרם קלט.
דוגמאות
using (var archive = new LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lzma");
}
חריגים
לקרוא אין את ההרשאה הנדרשת לפתוח את הfileInfo
.
נתיב הקובץ ריק או מכיל רק רווחים.
הקובץ לא נמצא.
הנתיב לקובץ הוא קובץ קריאה בלבד או תיקיה.
fileInfo
הוא null.
הנתיב שנבחר אינו חוקי, כמו למשל שהוא נמצא בדרייב לא ממופה.
הקובץ כבר פתוח.
SetSource(string)
מגדיר את התוכן שידחס בתוך הארכיון.
public void SetSource(string sourcePath)
פרמטרים
sourcePath
string
נתיב לקובץ שייפתח כזרם קלט.
דוגמאות
using (var archive = new LzmaArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lzma");
}
חריגים
sourcePath
הוא null.
לקרוא אין את ההרשאה הנדרשת לגישה.
הsourcePath
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
הגישה לקובץ sourcePath
נדחתה.
הsourcePath
, שם הקובץ, או שניהם חורגים מהמגבלה המקסימלית המוגדרת על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, נתיבים חייבים להיות פחות מ-248 תווים, ושמות קבצים חייבים להיות פחות מ-260 תווים.
הקובץ בsourcePath
מכיל נקודתיים (:) באמצע המחרוזת.