Class TarEntry
Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)
מייצג קובץ בודד בתוך ארכיון tar.
public class 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; }
ערך מאפיין
Length
מקבל את אורך הפריט בבתים.
public long Length { get; }
ערך מאפיין
Name
מקבל או קובע את שם הפריט בתוך הארכיון.
public string Name { get; set; }
ערך מאפיין
שיטות
Extract(string)
מוציא את הפריט למערכת הקבצים לפי הנתיב שסופק.
public FileSystemInfo Extract(string path)
פרמטרים
path
string
הנתיב לקובץ היעד. אם הקובץ כבר קיים, הוא י overwritten.
מחזיר
מידע על הקובץ המורכב.
דוגמאות
using (var archive = new TarArchive("archive.tar"))
{
archive.Entries[0].Extract("data.bin");
}
חריגות
path
הוא null.
למתקשר אין את ההרשאה הנדרשת לגישה.
ה path
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
גישה לקובץ path
נדחתה.
ה path
, שם הקובץ, או שניהם חורגים מהאורך המקסימלי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, נתיבים חייבים להיות פחות מ-248 תווים, ושמות קבצים חייבים להיות פחות מ-260 תווים.
הקובץ ב path
מכיל נקודתיים (:) באמצע המחרוזת.
הקובץ לא נמצא.
הנתיב שצוין אינו חוקי, כמו למשל כאשר הוא נמצא בכונן שאינו ממופה.
הקובץ כבר פתוח.
Extract(Stream)
מוציא את הפריט לזרם שסופק.
public void Extract(Stream destination)
פרמטרים
destination
Stream
זרם היעד. חייב להיות ניתן לכתיבה.
דוגמאות
מוציא פריט מארכיון tar.
using (var archive = new TarArchive("archive.tar"))
{
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>
#### הערות
קרא מהזרם כדי לקבל את התוכן המקורי של הקובץ. ראה את סעיף הדוגמאות.