Class CabEntry
Namespace: Aspose.Zip.Cab
Assembly: Aspose.Zip.dll (25.1.0)
מייצג קובץ בודד בתוך ארכיון cab.
public sealed class CabEntry : IArchiveFileEntry
ירושה
מיישם
חברים שהורשו
object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
מאפיינים
אורך
מקבל את האורך של הפריט בבתים.
public uint Length { get; }
ערך מאפיין
שם
מקבל את שמו של הפריט בתוך הארכיון.
public string Name { get; }
ערך מאפיין
שיטות
Extract(string)
מחלץ את הפריט למערכת הקבצים לפי הנתיב שניתן.
public FileInfo Extract(string path)
פרמטרים
path
string
הנתיב לקובץ היעד. אם הקובץ כבר קיים, הוא יוחלף.
מחזיר
מידע על הקובץ המורכב.
דוגמאות
using (var archive = new CabArchive("archive.cab"))
{
archive.Entries[0].Extract("data.bin");
}
חריגים
path
הוא null.
למתקשר אין את ההרשאה הנדרשת לגישה.
הpath
ריק, מכיל רק רווחים או מכיל תווים לא חוקיים.
הגישה לקובץ path
נדחתה.
הpath
, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, נתיבים חייבים להיות פחות מ-248 תווים, ושמות קבצים חייבים להיות פחות מ-260 תווים.
הקובץ בpath
מכיל נקודתיים (:) באמצע המחרוזת.
הקובץ לא נמצא.
הנתיב שניתן אינו חוקי, כמו למשל כאשר הוא נמצא בכונן שאינו ממופה.
הקובץ כבר פתוח.
אתחול הזרם נכשל עקב נתונים שגויים.
הארכיון פגום.
Extract(Stream)
מחלץ את הפריט לזרם שניתן.
public void Extract(Stream destination)
פרמטרים
destination
Stream
זרם היעד. חייב להיות ניתן לכתיבה.
דוגמאות
מחלץ פריט מארכיון cab.
using (var archive = new CabArchive("archive.cab"))
{
archive.Entries[0].Extract(httpResponseStream);
}
חריגים
destination
לא תומך בכתיבה.
אתחול הזרם נכשל עקב נתונים שגויים.
הארכיון פגום.
Open()
פותח את הפריט להוצאה ומספק זרם עם תוכן הפריט.
public Stream Open()
מחזיר
הזרם המייצג את התוכן של הפריט.
דוגמאות
שימוש:
Stream decompressed = entry.Open();
.NET 4.0 ומעלה - השתמש בשיטת Stream.CopyTo:
decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 ומטה - העתק בתים ידנית:
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### הערות
קרא מהזרם כדי לקבל את התוכן המקורי של הקובץ. ראה את סעיף הדוגמאות.
#### חריגים
[NotSupportedException](https://learn.microsoft.com/dotnet/api/system.notsupportedexception)
אתחול הזרם נכשל עקב נתונים שגויים.
[InvalidDataException](https://learn.microsoft.com/dotnet/api/system.io.invaliddataexception)
הארכיון פגום.
### <a id="Aspose_Zip_Cab_CabEntry_ToString"></a> ToString\(\)
```csharp
public override string ToString()