Class CabEntry

Class CabEntry

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

מייצג קובץ בודד בתוך ארכיון cab.

public sealed class CabEntry : IArchiveFileEntry

ירושה

object ← CabEntry

מיישם

IArchiveFileEntry

חברים שהורשו

object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

מאפיינים

אורך

מקבל את האורך של הפריט בבתים.

public uint Length { get; }

ערך מאפיין

uint

שם

מקבל את שמו של הפריט בתוך הארכיון.

public string Name { get; }

ערך מאפיין

string

שיטות

Extract(string)

מחלץ את הפריט למערכת הקבצים לפי הנתיב שניתן.

public FileInfo Extract(string path)

פרמטרים

path string

הנתיב לקובץ היעד. אם הקובץ כבר קיים, הוא יוחלף.

מחזיר

FileInfo

מידע על הקובץ המורכב.

דוגמאות 

using (var archive = new CabArchive("archive.cab"))
{
    archive.Entries[0].Extract("data.bin");
}

חריגים

ArgumentNullException

path הוא null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

NotSupportedException

אתחול הזרם נכשל עקב נתונים שגויים.

InvalidDataException

הארכיון פגום.

Extract(Stream)

מחלץ את הפריט לזרם שניתן.

public void Extract(Stream destination)

פרמטרים

destination Stream

זרם היעד. חייב להיות ניתן לכתיבה.

דוגמאות

מחלץ פריט מארכיון cab.

using (var archive = new CabArchive("archive.cab"))
{
    archive.Entries[0].Extract(httpResponseStream);
}

חריגים

ArgumentException

destination לא תומך בכתיבה.

NotSupportedException

אתחול הזרם נכשל עקב נתונים שגויים.

InvalidDataException

הארכיון פגום.

Open()

פותח את הפריט להוצאה ומספק זרם עם תוכן הפריט.

public Stream Open()

מחזיר

Stream

הזרם המייצג את התוכן של הפריט.

דוגמאות

שימוש: 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()

מחזיר

string

 Ελληνικά