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 אינו ניתן לכתיבה.
