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

مسیر به فایل مقصد. اگر فایل قبلاً وجود داشته باشد، جایگزین خواهد شد.

بازگشت

FileSystemInfo

اطلاعات فایل فایل ترکیبی.

مثال‌ها

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

استثناها

ArgumentNullException

path نال است.

SecurityException

فراخوانی‌کننده اجازه لازم برای دسترسی را ندارد.

ArgumentException

path خالی است، فقط شامل فضای خالی است، یا شامل کاراکترهای نامعتبر است.

UnauthorizedAccessException

دسترسی به فایل path رد شده است.

PathTooLongException

path، نام فایل، یا هر دو از حداکثر طول تعریف شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 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>

#### توضیحات

از جریان بخوانید تا محتوای اصلی فایل را دریافت کنید. به بخش مثال‌ها مراجعه کنید.