Class RarArchiveEntry

Class RarArchiveEntry

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

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

public abstract class RarArchiveEntry : IArchiveFileEntry

ירושה

objectRarArchiveEntry

נגזר

RarArchiveEntryEncrypted, RarArchiveEntryPlain

מממש

IArchiveFileEntry

חברים מורשים

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

הערות

המירו מופע של Aspose.Zip.Rar.RarArchiveEntry ל-Aspose.Zip.Rar.RarArchiveEntryEncrypted כדי לקבוע אם הפריט מוצפן או לא.

מאפיינים

CompressedSize

מקבל את גודל הקובץ המכווץ.

public ulong CompressedSize { get; }

ערך המאפיין

ulong

CreationTime

מקבל את תאריך ושעת היצירה.

public DateTime CreationTime { get; }

ערך המאפיין

DateTime

IsDirectory

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

public bool IsDirectory { get; }

ערך המאפיין

bool

LastAccessTime

מקבל את תאריך ושעת הגישה האחרונה.

public DateTime LastAccessTime { get; }

ערך המאפיין

DateTime

ModificationTime

מקבל את תאריך ושעת השינוי האחרונים.

public DateTime ModificationTime { get; }

ערך המאפיין

DateTime

Name

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

public string Name { get; }

ערך המאפיין

string

Source

מקבל את זרם מקור הנתונים עבור הפריט.

protected Stream Source { get; set; }

ערך המאפיין

Stream

UncompressedSize

מקבל את גודל הקובץ המקורי.

public ulong UncompressedSize { get; }

ערך המאפיין

ulong

שיטות

Extract(string, string)

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

public FileInfo Extract(string path, string password = null)

פרמטרים

path string

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

password string

סיסמה אופציונלית לפענוח.

מחזיר

FileInfo

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

דוגמאות

מוציאים שני פריטים מארכיון rar.

using (FileStream rarFile = File.Open("archive.rar", FileMode.Open))
{
    using (RarArchive archive = new RarArchive(rarFile))
    {
        archive.Entries[0].Extract("first.bin", "pass");
        archive.Entries[1].Extract("second.bin", "pass");
    }
}

חריגות

ArgumentNullException

path הוא null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

הנתיב שניתן אינו תקף, כגון שהוא נמצא בכונן שאינו ממופה.

IOException

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

InvalidDataException

הנתונים פגומים. -או- אימות CRC או MAC נכשל עבור הפריט.

Extract(Stream, string)

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

public void Extract(Stream destination, string password = null)

פרמטרים

destination Stream

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

password string

סיסמה אופציונלית לפענוח.

דוגמאות

מוציאים פריט מארכיון rar עם סיסמה.

using (FileStream rarFile = File.Open("archive.zip", FileMode.Open))
{
    using (RarArchive archive = new RarArchive(rarFile))
    {
        archive.Entries[0].Extract(httpResponseStream, "p@s$");
    }
}

חריגות

InvalidDataException

אימות CRC או MAC נכשל עבור הפריט.

ArgumentException

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

InvalidDataException

הנתונים פגומים. -או- אימות CRC או MAC נכשל עבור הפריט.

Open(string)

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

public Stream Open(string password = null)

פרמטרים

password string

סיסמה אופציונלית לפענוח. ניתן גם להגדיר זאת בתוך Aspose.Zip.Rar.RarArchiveLoadOptions.DecryptionPassword.

מחזיר

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>

#### הערות

<p>קראו מהזרם כדי לקבל את תוכן הקובץ המקורי. ראה את סעיף הדוגמאות.</p>

### <a id="Aspose_Zip_Rar_RarArchiveEntry_ExtractionProgressed"></a> ExtractionProgressed

מתרחש כאשר חלק מזרם גולמי הוצא.

```csharp
public event EventHandler<progresseventargs> ExtractionProgressed

סוג אירוע

EventHandler<ProgressEventArgs&gt;

דוגמאות

archive.Entries[0].ExtractionProgressed += (s, e) =&gt; { int percent = (int)((100 * e.ProceededBytes) / ((RarArchiveEntry)s).UncompressedSize); };

הערות

שולח האירוע הוא מופע של Aspose.Zip.Rar.RarArchiveEntry.

 Ελληνικά