Class CabArchive
Namespace: Aspose.Zip.Cab
Assembly: Aspose.Zip.dll (25.1.0)
כיתה זו מייצגת קובץ ארכיון cab.
public class CabArchive : IArchive, IDisposable
ירושה
מיישם
חברים שהורשו
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
בונים
CabArchive(Stream)
מאתחל מופע חדש של כיתה Aspose.Zip.Cab.CabArchive ומרכיב רשימת כניסות שניתן לחלץ מהארכיון.
public CabArchive(Stream sourceStream)
פרמטרים
sourceStream
Stream
מקור הארכיון. הוא חייב להיות ניתן לחיפוש.
דוגמאות
הדוגמה הבאה מראה כיצד לחלץ את כל הכניסות לתיקיה.
using (var archive = new CabArchive(File.OpenRead("archive.cab")))
{
archive.ExtractToDirectory("C:\extracted");
}
הערות
בונה זה אינו מפרק אף כניסה. ראה את שיטת Aspose.Zip.Cab.CabEntry.Open עבור פירוק.
חריגות
sourceStream
הוא null.
sourceStream
אינו ניתן לחיפוש.
sourceStream
אינו ארכיון cab תקף.
הזרם קצר מדי.
CabArchive(string)
מאתחל מופע חדש של כיתה Aspose.Zip.Cab.CabArchive ומרכיב רשימת כניסות שניתן לחלץ מהארכיון.
public CabArchive(string path)
פרמטרים
path
string
הנתיב לקובץ הארכיון.
דוגמאות
הדוגמה הבאה מראה כיצד לחלץ את כל הכניסות לתיקיה.
using (var archive = new CabArchive("archive.cab"))
{
archive.ExtractToDirectory("C:\extracted");
}
הערות
בונה זה אינו מפרק אף כניסה. ראה את שיטת Aspose.Zip.Cab.CabEntry.Open עבור פירוק.
חריגות
path
הוא null.
המבצע אינו מחזיק בהרשאה הנדרשת לגישה.
path
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
גישה לקובץ path
נדחתה.
path
, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, נתיבים חייבים להיות פחות מ-248 תווים, ושמות קבצים חייבים להיות פחות מ-260 תווים.
הקובץ בpath
מכיל נקודתיים (:) באמצע המחרוזת.
הקובץ לא נמצא.
הנתיב שנבחר אינו חוקי, כמו למשל שהוא נמצא בכונן שלא ממופה.
הקובץ כבר פתוח.
הקובץ קצר מדי.
מאפיינים
Entries
מקבל את הכניסות מסוג Aspose.Zip.Cab.CabEntry שמרכיבות את הארכיון.
public ReadOnlyCollection<cabentry> Entries { get; }
ערך המאפיין
ReadOnlyCollection<CabEntry>
שיטות
Dispose(bool)
מבצע משימות שהוגדרו על ידי היישום הקשורות לשחרור, שחרור או אפס של משאבים לא מנוהלים.
protected virtual void Dispose(bool disposing)
פרמטרים
disposing
bool
האם יש לשחרר משאבים מנוהלים.
Dispose()
מבצע משימות שהוגדרו על ידי היישום הקשורות לשחרור, שחרור או אפס של משאבים לא מנוהלים.
public void Dispose()
ExtractToDirectory(string)
חולץ את כל הקבצים בארכיון לתיקיה שסופקה.
public void ExtractToDirectory(string destinationDirectory)
פרמטרים
destinationDirectory
string
הנתיב לתיקיה בה יונחו הקבצים המוחלצים.
דוגמאות
using (var archive = new CabArchive("archive.cab"))
{
archive.ExtractToDirectory("C:\extracted");
}
הערות
אם התיקיה אינה קיימת, היא תיווצר.
חריגות
path הוא null
הנתיב, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת.
המבצע אינו מחזיק בהרשאה הנדרשת לגישה לתיקיה קיימת.
אם התיקיה אינה קיימת, הנתיב מכיל תו נקודתיים (:) שאינו חלק מתווית הכונן (“C:").
הנתיב הוא מחרוזת באורך אפס, מכיל רק רווחים, או מכיל תו לא חוקי אחד או יותר. ניתן לשאול לגבי תווים לא חוקיים באמצעות השיטה System.IO.Path.GetInvalidPathChars. -או- הנתיב מתחיל ב, או מכיל, רק תו נקודתיים (:).
התיקיה המצוינת על ידי הנתיב היא קובץ. -או- שם הרשת אינו ידוע.
הארכיון פגום.