Class SevenZipArchiveEntry

Class SevenZipArchiveEntry

نام ها : Aspose.Zip.SevenZip جمع آوری: Aspose.Zip.dll (25.5.0)

یک فایل در یک آرشیو 7Z ارائه می شود.

public abstract class SevenZipArchiveEntry : IArchiveFileEntry

Inheritance

object ← SevenZipArchiveEntry

Derived

SevenZipArchiveEntryEncrypted , SevenZipArchiveEntryPlain

Implements

IArchiveFileEntry

اعضای ارثی

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

Remarks

یک Aspose.Zip.SevenZip.SevenZipArchiveEntry به Aspose.Zip.SevenZip.SevenZipArchiveEntry رمزگذاری شده برای تعیین اینکه آیا ورودی رمزگذاری شده است یا نه.

Properties

CompressedSize

اندازه یک فایل فشرده را دریافت کنید.

public ulong CompressedSize { get; }

ارزش املاک

ulong

CompressionSettings

تنظیمات برای فشرده سازی یا فشرده سازی

public SevenZipCompressionSettings CompressionSettings { get; }

ارزش املاک

SevenZipCompressionSettings

FileAttributes

ویژگی های فایل را از یک سیستم میزبان دریافت می کند.

protected FileAttributes FileAttributes { get; }

ارزش املاک

FileAttributes

IsDirectory

یک مقدار دریافت می کند که نشان می دهد آیا ورودی یک دایرکتوری را نشان می دهد.

public bool IsDirectory { get; }

ارزش املاک

bool

ModificationTime

آخرین تاریخ و زمان اصلاح شده را دریافت کنید.

public DateTime ModificationTime { get; }

ارزش املاک

DateTime

Name

نام ورودی را در داخل آرشیو دریافت کنید.

public string Name { get; protected set; }

ارزش املاک

string

Source

جریان منبع داده را برای ورودی دریافت کنید.

protected Stream Source { get; }

ارزش املاک

Stream

UncompressedSize

اندازه یک فایل اصلی را دریافت کنید.

public ulong UncompressedSize { get; }

ارزش املاک

ulong

Methods

Extract(String، String)

وارد سیستم فایل را از طریق مسیر ارائه شده خارج می کند.

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

Parameters

path string

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

password string

رمز عبور اختیاری برای رمزگذاری

Returns

FileInfo

اطلاعات مربوط به یک فایل ترکیب شده

Examples 

using (var archive = new SevenZipArchive("archive.7z"))
{
    archive.Entries[0].Extract("data.bin");
}

Exceptions

ArgumentNullException

path’ is null.

SecurityException

متقاضی مجوز لازم برای دسترسی ندارد.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

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

PathTooLongException

برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.

NotSupportedException

فایل در path" حاوی یک ستون (:) در وسط ردیف است.

InvalidDataException

این آرشیو خراب شده است.

Extract(جریان، string)

ورودی را به جریان ارائه شده استخراج کنید.

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

Parameters

destination Stream

بایگانی برچسب ها: باید نوشته شود

password string

رمز عبور اختیاری برای رمزگذاری

Examples

یک ورودی از آرشیو ZIP با رمز عبور استخراج کنید.

using (var archive = new SevenZipArchive("archive.7z"))
{
    archive.Entries[0].Extract(httpResponseStream);
}

Exceptions

ArgumentException

destination’ does not support writing.

InvalidOperationException

آرشیو برای استخراج باز نیست. - یا - این ورودی یک دایرکتوری است.

InvalidDataException

اطلاعات نادرست در ورودی

FinalizeCompressedData(بایت، بایت[])

برای خروجی هر عنوان را که داده های فشرده را دنبال می کند، بنویسید.

protected abstract int FinalizeCompressedData(Stream outputStream, byte[] encoderProperties)

Parameters

outputStream Stream

جریان خروجی برای ورودی

encoderProperties byte [ ]

ویژگی های فشرده سازی

Returns

int

تعداد بایت های “تکنیکی” که پس از ورود به بلوک داده های قابل توجهی اضافه شده است.

GetDestinationStream(Stream)

جریان مقصد برای ورودی، می تواند تزئین شود.

protected abstract Stream GetDestinationStream(Stream outputStream)

Parameters

outputStream Stream

جریان خروجی برای ورودی

Returns

Stream

جریان مقصد برای فشرده سازی ورودی

Open(String)

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

public Stream Open(string password = null)

Parameters

password string

رمز عبور اختیاری برای رمزگذاری

Returns

Stream

جریان که محتوای ورودی را نشان می دهد.

Examples

استفاده :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>

#### Remarks

Read from the stream to get the original content of a file. See examples section.

#### Exceptions

 [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)

The archive is not opened for extraction. - or - This entry is a directory.

 [InvalidDataException](https://learn.microsoft.com/dotnet/api/system.io.invaliddataexception)

Wrong data within the entry.

### <a id="Aspose_Zip_SevenZip_SevenZipArchiveEntry_CompressionProgressed"></a> CompressionProgressed

Raises when a portion of raw stream compressed.

```csharp
public event EventHandler<progresseventargs> CompressionProgressed

نوع رویداد

EventHandler &lt؛ ProgressEventArgs >

Examples

archive.Entries[0].CompressionProgressed += (s, e) =&gt; { int percent = (int)((100 * (long)e.ProceededBytes) / entrySourceStream.Length); };

Remarks

فرستنده رویداد یک مثال Aspose.Zip.SevenZip.SevenZipArchiveEntry است.

در حالت چند رشته ای برای ورودی های LZMA2 درخواست نمی شود.

 فارسی