Class TarEntry

Class TarEntry

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

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

public class TarEntry : IArchiveFileEntry

ירושה

object ← TarEntry

מיישם

IArchiveFileEntry

חברים ירושים

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

מאפיינים

IsDirectory

מקבל ערך שמצביע האם הפריט מייצג תיקייה.

public bool IsDirectory { get; }

ערך מאפיין

bool

Length

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

public long Length { get; }

ערך מאפיין

long

Name

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

public string Name { get; set; }

ערך מאפיין

string

שיטות

Extract(string)

מוציא את הפריט למערכת הקבצים לפי הנתיב שסופק.

public FileSystemInfo Extract(string path)

פרמטרים

path string

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

מחזיר

FileSystemInfo

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

דוגמאות 

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

חריגות

ArgumentNullException

path הוא null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

Extract(Stream)

מוציא את הפריט לזרם שסופק.

public void Extract(Stream destination)

פרמטרים

destination Stream

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

דוגמאות

מוציא פריט מארכיון tar.

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

חריגות

ArgumentException

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

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>

#### הערות

קרא מהזרם כדי לקבל את התוכן המקורי של הקובץ. ראה את סעיף הדוגמאות.
 Ελληνικά