Class IsoArchive
Namespace: Aspose.Zip.Iso
Assembly: Aspose.Zip.dll (25.1.0)
מייצג ארכיון ISO (ISO 9660).
public sealed class IsoArchive : IArchive, IDisposable
ירושה
מיישם
חברים ירושים
object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
בונים
IsoArchive()
מאתחל מופע חדש של מחלקת Aspose.Zip.Iso.IsoArchive ויוצר ארכיון ISO ריק להוספת קבצים ודירקטוריות חדשים.
public IsoArchive()
דוגמאות
הדוגמה הבאה מראה כיצד ליצור ארכיון ISO ריק חדש ולהוסיף אליו קבצים:
// צור ארכיון ISO ריק חדש
using(IsoArchive isoArchive = new IsoArchive())
{
// הוסף קבצים לארכיון ISO
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// שמור את ארכיון ה-ISO לקובץ
isoArchive.Save("new_archive.iso");
}
IsoArchive(Stream, IsoLoadOptions)
מאתחל מופע חדש של מחלקת Aspose.Zip.Iso.IsoArchive ומרכיב רשימת פריטים שניתן לחלץ מהארכיון.
public IsoArchive(Stream sourceStream, IsoLoadOptions loadOptions = null)
פרמטרים
sourceStream
Stream
מקור הארכיון. הוא חייב להיות ניתן לחיפוש.
loadOptions
IsoLoadOptions
האפשרויות לטעינת הארכיון.
דוגמאות
הדוגמה הבאה מראה כיצד לחלץ את כל הפריטים לתוך דירקטוריה.
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}
הערות
בונה זה אינו מפרק אף פריט.
חריגות
sourceStream
הוא null.
sourceStream
אינו ניתן לחיפוש.
sourceStream
אינו ארכיון ISO תקף.
IsoArchive(string, IsoLoadOptions)
מאתחל מופע חדש של מחלקת Aspose.Zip.Iso.IsoArchive ומרכיב רשימת פריטים שניתן לחלץ מהארכיון.
public IsoArchive(string path, IsoLoadOptions loadOptions = null)
פרמטרים
path
string
הנתיב לקובץ הארכיון.
loadOptions
IsoLoadOptions
האפשרויות לטעינת הארכיון.
דוגמאות
הדוגמה הבאה מראה כיצד לחלץ את כל הפריטים לתוך דירקטוריה.
using (var archive = new IsoArchive("archive.iso"))
{
archive.ExtractToDirectory("C:\\extracted");
}
הערות
בונה זה אינו מפרק אף פריט.
חריגות
path
הוא null.
לקרוא אין את ההרשאה הנדרשת לגישה.
הpath
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
הגישה לקובץ path
נדחתה.
הpath
, שם הקובץ, או שניהם חורגים מהאורך המקסימלי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, הנתיבים חייבים להיות פחות מ-248 תווים, ושמות הקבצים חייבים להיות פחות מ-260 תווים.
הקובץ בpath
מכיל נקודתיים (:) באמצע המחרוזת.
הקובץ לא נמצא.
הנתיב שנבחר אינו תקף, כמו למשל כאשר הוא נמצא בכונן שאינו ממופה.
הקובץ כבר פתוח.
הקובץ קצר מדי.
מאפיינים
Entries
מקבל את הפריטים מסוג Aspose.Zip.Iso.IsoEntry המהווים את הארכיון.
public ReadOnlyCollection<isoentry> Entries { get; }
ערך המאפיין
ReadOnlyCollection<IsoEntry>
שיטות
CreateDirectory(string)
מוסיף דירקטוריה לתמונה של ה-ISO.
public IsoEntry CreateDirectory(string name)
פרמטרים
name
string
הנתיב של הדירקטוריה ב-ISO.
מחזיר
הפריט ב-ISO שנוצר.
חריגות
הארכיון פתוח לחילוץ.
name
הוא null או ריק.
CreateEntry(string, string)
מוסיף קובץ לתמונה של ה-ISO.
public IsoEntry CreateEntry(string name, string filePath)
פרמטרים
name
string
הנתיב של הקובץ ב-ISO.
filePath
string
הנתיב של הקובץ.
מחזיר
הפריט ב-ISO שנוצר.
חריגות
הfilePath
הוא null.
הfilePath
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
הגישה לקובץ filePath
נדחתה.
הfilePath
שנבחר חורג מהאורך המקסימלי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, הנתיבים חייבים להיות פחות מ-248 תווים, ושמות הקבצים חייבים להיות פחות מ-260 תווים.
הקובץ בfilePath
מכיל נקודתיים (:) באמצע המחרוזת.
שגיאת I/O התרחשה בזמן פתיחת הקובץ.
CreateEntry(string, Stream)
מוסיף קובץ לתמונה של ה-ISO.
public IsoEntry CreateEntry(string name, Stream source)
פרמטרים
name
string
הנתיב של הקובץ ב-ISO.
source
Stream
זרם המכיל את נתוני הקובץ.
מחזיר
הפריט ב-ISO שנוצר.
CreateEntry(string)
מוסיף קובץ לתמונה של ה-ISO.
public IsoEntry CreateEntry(string name)
פרמטרים
name
string
הנתיב של הדירקטוריה ב-ISO.
מחזיר
הפריט ב-ISO שנוצר.
חריגות
name
הוא null או ריק.
הארכיון פתוח לחילוץ.
Dispose()
מבצע משימות מוגדרות על ידי היישום הקשורות לשחרור, שחרור או איפוס של משאבים לא מנוהלים.
public void Dispose()
ExtractToDirectory(string)
מחלץ את כל הפריטים לדירקטוריה המצוינת.
public void ExtractToDirectory(string destinationDirectory)
פרמטרים
destinationDirectory
string
הדירקטוריה אליה ייחלצו הפריטים.
דוגמאות
הדוגמה הבאה מראה כיצד לחלץ את כל הפריטים לדירקטוריה:
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}
חריגות
נזרק כאשר הארכיון במצב עריכה.
נזרק כאשר הdestinationDirectory
הוא null.
Save(string, IsoSaveOptions)
שומר את תמונת ה-ISO בנתיב המצויין.
public void Save(string path, IsoSaveOptions saveOptions = null)
פרמטרים
path
string
הנתיב שבו תישמר תמונת ה-ISO.
saveOptions
IsoSaveOptions
אפשרויות לשמירת הארכיון ISO.
דוגמאות
הדוגמה הבאה מראה כיצד לשמור ארכיון ISO לקובץ:
// צור ארכיון ISO ריק חדש
using(IsoArchive isoArchive = new IsoArchive())
{
// הוסף קבצים לארכיון ISO
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// שמור את ארכיון ה-ISO לקובץ
isoArchive.Save("new_archive.iso");
}
חריגות
נזרק כאשר הארכיון אינו במצב עריכה.
נזרק כאשר הpath
הוא null.
נזרק כאשר הנתיב שנבחר אינו תקף, כמו למשל כאשר הוא נמצא בכונן שאינו ממופה.
נזרק כאשר הקובץ כבר פתוח.
נזרק כאשר הגישה לקובץ path
נדחתה.
נזרק כאשר הpath
שנבחר חורג מהאורך המקסימלי המוגדר על ידי המערכת.
Save(Stream, IsoSaveOptions)
שומר את תמונת ה-ISO לזרם המצויין.
public void Save(Stream stream, IsoSaveOptions saveOptions = null)
פרמטרים
stream
Stream
הזרם שבו תישמר תמונת ה-ISO.
saveOptions
IsoSaveOptions
אפשרויות לשמירת הארכיון ISO.
דוגמאות
הדוגמה הבאה מראה כיצד לשמור ארכיון ISO לזרם זיכרון:
// צור ארכיון ISO ריק חדש
using(IsoArchive isoArchive = new IsoArchive())
{
// הוסף קבצים לארכיון ISO
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// שמור את ארכיון ה-ISO לזרם זיכרון
isoArchive.Save(memoryStream);
}
חריגות
נזרק כאשר הארכיון אינו במצב עריכה.
נזרק כאשר הstream
הוא null.
נזרק כאשר הstream
אינו ניתן לכתיבה.