Class IsoArchive

Class IsoArchive

Namespace: Aspose.Zip.Iso
Assembly: Aspose.Zip.dll (25.1.0)

מייצג ארכיון ISO (ISO 9660).

public sealed class IsoArchive : IArchive, IDisposable

ירושה

objectIsoArchive

מיישם

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");
}

הערות

בונה זה אינו מפרק אף פריט.

חריגות

ArgumentNullException

sourceStream הוא null.

ArgumentException

sourceStream אינו ניתן לחיפוש.

InvalidDataException

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");
}

הערות

בונה זה אינו מפרק אף פריט.

חריגות

ArgumentNullException

path הוא null.

SecurityException

לקרוא אין את ההרשאה הנדרשת לגישה.

ArgumentException

הpath ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.

UnauthorizedAccessException

הגישה לקובץ path נדחתה.

PathTooLongException

הpath, שם הקובץ, או שניהם חורגים מהאורך המקסימלי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, הנתיבים חייבים להיות פחות מ-248 תווים, ושמות הקבצים חייבים להיות פחות מ-260 תווים.

NotSupportedException

הקובץ בpath מכיל נקודתיים (:) באמצע המחרוזת.

FileNotFoundException

הקובץ לא נמצא.

DirectoryNotFoundException

הנתיב שנבחר אינו תקף, כמו למשל כאשר הוא נמצא בכונן שאינו ממופה.

IOException

הקובץ כבר פתוח.

EndOfStreamException

הקובץ קצר מדי.

מאפיינים

Entries

מקבל את הפריטים מסוג Aspose.Zip.Iso.IsoEntry המהווים את הארכיון.

public ReadOnlyCollection<isoentry> Entries { get; }

ערך המאפיין

ReadOnlyCollection<IsoEntry&gt;

שיטות

CreateDirectory(string)

מוסיף דירקטוריה לתמונה של ה-ISO.

public IsoEntry CreateDirectory(string name)

פרמטרים

name string

הנתיב של הדירקטוריה ב-ISO.

מחזיר

IsoEntry

הפריט ב-ISO שנוצר.

חריגות

InvalidOperationException

הארכיון פתוח לחילוץ.

ArgumentNullException

name הוא null או ריק.

CreateEntry(string, string)

מוסיף קובץ לתמונה של ה-ISO.

public IsoEntry CreateEntry(string name, string filePath)

פרמטרים

name string

הנתיב של הקובץ ב-ISO.

filePath string

הנתיב של הקובץ.

מחזיר

IsoEntry

הפריט ב-ISO שנוצר.

חריגות

ArgumentNullException

הfilePath הוא null.

ArgumentException

הfilePath ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.

UnauthorizedAccessException

הגישה לקובץ filePath נדחתה.

PathTooLongException

הfilePath שנבחר חורג מהאורך המקסימלי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, הנתיבים חייבים להיות פחות מ-248 תווים, ושמות הקבצים חייבים להיות פחות מ-260 תווים.

NotSupportedException

הקובץ בfilePath מכיל נקודתיים (:) באמצע המחרוזת.

IOException

שגיאת I/O התרחשה בזמן פתיחת הקובץ.

CreateEntry(string, Stream)

מוסיף קובץ לתמונה של ה-ISO.

public IsoEntry CreateEntry(string name, Stream source)

פרמטרים

name string

הנתיב של הקובץ ב-ISO.

source Stream

זרם המכיל את נתוני הקובץ.

מחזיר

IsoEntry

הפריט ב-ISO שנוצר.

CreateEntry(string)

מוסיף קובץ לתמונה של ה-ISO.

public IsoEntry CreateEntry(string name)

פרמטרים

name string

הנתיב של הדירקטוריה ב-ISO.

מחזיר

IsoEntry

הפריט ב-ISO שנוצר.

חריגות

ArgumentNullException

name הוא null או ריק.

InvalidOperationException

הארכיון פתוח לחילוץ.

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");
}

חריגות

InvalidOperationException

נזרק כאשר הארכיון במצב עריכה.

ArgumentNullException

נזרק כאשר ה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");
}

חריגות

InvalidOperationException

נזרק כאשר הארכיון אינו במצב עריכה.

ArgumentNullException

נזרק כאשר הpath הוא null.

DirectoryNotFoundException

נזרק כאשר הנתיב שנבחר אינו תקף, כמו למשל כאשר הוא נמצא בכונן שאינו ממופה.

IOException

נזרק כאשר הקובץ כבר פתוח.

UnauthorizedAccessException

נזרק כאשר הגישה לקובץ path נדחתה.

PathTooLongException

נזרק כאשר ה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);
}

חריגות

InvalidOperationException

נזרק כאשר הארכיון אינו במצב עריכה.

ArgumentNullException

נזרק כאשר הstream הוא null.

ArgumentException

נזרק כאשר הstream אינו ניתן לכתיבה.

 Ελληνικά