Class UueArchive

Class UueArchive

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

این کلاس نمایانگر فایل uuencoded است.

public class UueArchive : IArchive, IDisposable, IArchiveFileEntry

وراثت

object ← UueArchive

پیاده‌سازی‌ها

IArchive, IDisposable, IArchiveFileEntry

اعضای وراثت‌یافته

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

سازنده‌ها

UueArchive()

یک نمونه جدید از کلاس Aspose.Zip.Uue.UueArchive را برای کدگذاری آماده می‌کند.

public UueArchive()

مثال‌ها

مثال زیر نشان می‌دهد که چگونه یک فایل را uuencode کنید.

using (var archive = new UueArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.uue");
}

UueArchive(Stream)

یک نمونه جدید از کلاس Aspose.Zip.Uue.UueArchive را برای رمزگشایی آماده می‌کند.

public UueArchive(Stream sourceStream)

پارامترها

sourceStream Stream

منبع آرشیو.

مثال‌ها

آرشیو را از یک استریم باز کنید و آن را به یک MemoryStream استخراج کنید

var ms = new MemoryStream();
using (var archive = new UueArchive(File.OpenRead("archive.001")))
  archive.Open().CopyTo(ms);

توضیحات

این سازنده رمزگشایی نمی‌کند. برای فشرده‌سازی، به متد Aspose.Zip.Uue.UueArchive.Open مراجعه کنید.

UueArchive(string)

یک نمونه جدید از کلاس Aspose.Zip.Uue.UueArchive را ایجاد می‌کند.

public UueArchive(string path)

پارامترها

path string

مسیر فایل آرشیو.

مثال‌ها

آرشیو را از فایل با مسیر باز کنید و آن را به یک MemoryStream رمزگشایی کنید

var ms = new MemoryStream();
using (var archive = new UueArchive("archive.uue"))
  archive.Open().CopyTo(ms);

توضیحات

این سازنده فشرده‌سازی نمی‌کند. برای فشرده‌سازی، به متد Aspose.Zip.Uue.UueArchive.Open مراجعه کنید.

استثناها

ArgumentNullException

path null است.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

دسترسی به فایل path ممنوع است.

PathTooLongException

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

NotSupportedException

فایل در path شامل دو نقطه (:) در وسط رشته است.

ویژگی‌ها

Name

نام فایل اصلی.

public string Name { get; }

مقدار ویژگی

string

متدها

Dispose()

وظایف تعریف‌شده توسط برنامه را برای آزادسازی، رهاسازی یا بازنشانی منابع غیرمدیریتی انجام می‌دهد.

public void Dispose()

Dispose(bool)

وظایف تعریف‌شده توسط برنامه را برای آزادسازی، رهاسازی یا بازنشانی منابع غیرمدیریتی انجام می‌دهد.

protected virtual void Dispose(bool disposing)

پارامترها

disposing bool

آیا منابع مدیریتی باید رها شوند.

Extract(Stream)

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

public void Extract(Stream destination)

پارامترها

destination Stream

استریم مقصد. باید قابل نوشتن باشد.

مثال‌ها 

using (var archive = new UueArchive("archive.uue"))
{
     archive.Extract(httpResponseStream);
}

استثناها

ArgumentException

destination از نوشتن پشتیبانی نمی‌کند.

Extract(string)

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

public FileInfo Extract(string path)

پارامترها

path string

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

بازگشت

FileInfo

اطلاعات فایل استخراج‌شده.

استثناها

ArgumentNullException

path null است.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

دسترسی به فایل path ممنوع است.

PathTooLongException

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

NotSupportedException

فایل در path شامل دو نقطه (:) در وسط رشته است.

FileNotFoundException

فایل پیدا نشد.

DirectoryNotFoundException

مسیر مشخص‌شده نامعتبر است، مانند اینکه در یک درایو غیرنقشه‌برداری باشد.

IOException

فایل از قبل باز است.

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

پارامترها

destinationDirectory string

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

توضیحات

اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.

استثناها

ArgumentNullException

destinationDirectory null است.

PathTooLongException

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

SecurityException

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

NotSupportedException

اگر دایرکتوری وجود نداشته باشد، مسیر شامل کاراکتر دو نقطه (:) باشد که بخشی از برچسب درایو نیست (“C:") باشد.

ArgumentException

destinationDirectory یک رشته با طول صفر است، فقط شامل فضای خالی است، یا شامل یک یا چند کاراکتر نامعتبر است. می‌توانید برای جستجوی کاراکترهای نامعتبر از متد System.IO.Path.GetInvalidPathChars استفاده کنید. -یا- مسیر با کاراکتر دو نقطه (:) شروع می‌شود یا فقط شامل کاراکتر دو نقطه است.

IOException

دایرکتوری مشخص‌شده توسط مسیر یک فایل است. -یا- نام شبکه شناخته نشده است.

Open()

آرشیو را برای رمزگشایی باز می‌کند و یک استریم با محتوای آرشیو ارائه می‌دهد.

public Stream Open()

بازگشت

Stream

استریم که محتوای آرشیو را نمایان می‌کند.

مثال‌ها

استفاده: Stream decompressed = archive.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>

#### توضیحات

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

### <a id="Aspose_Zip_Uue_UueArchive_Save_System_IO_Stream_Aspose_Zip_Uue_UueSaveOptions_"></a> Save\(Stream, UueSaveOptions\)

آرشیو را به استریم ارائه‌شده ذخیره می‌کند.

```csharp
public void Save(Stream outputStream, UueSaveOptions saveOptions = null)

پارامترها

outputStream Stream

استریم مقصد.

saveOptions UueSaveOptions

گزینه‌ها برای ذخیره آرشیو.

مثال‌ها

داده‌های فشرده‌شده را به استریم پاسخ http می‌نویسد.

using (var archive = new UueArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

توضیحات

outputStream باید قابل نوشتن باشد.

استثناها

InvalidOperationException

منبع داده‌ای که باید آرشیو شود، ارائه نشده است.

ArgumentException

outputStream قابل نوشتن نیست.

UnauthorizedAccessException

منبع فایل فقط خواندنی است یا یک دایرکتوری است.

DirectoryNotFoundException

مسیر منبع فایل مشخص‌شده نامعتبر است، مانند اینکه در یک درایو غیرنقشه‌برداری باشد.

IOException

منبع فایل از قبل باز است.

Save(string, UueSaveOptions)

آرشیو را به فایل مقصد ارائه‌شده ذخیره می‌کند.

public void Save(string destinationFileName, UueSaveOptions saveOptions = null)

پارامترها

destinationFileName string

مسیر آرشیو که باید ایجاد شود. اگر نام فایل مشخص‌شده به یک فایل موجود اشاره کند، بازنویسی خواهد شد.

saveOptions UueSaveOptions

گزینه‌ها برای ذخیره آرشیو.

مثال‌ها

داده‌های کدگذاری‌شده را به فایل می‌نویسد.

using (var archive = new UueArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.uue");
}

استثناها

ArgumentNullException

destinationFileName null است.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

دسترسی به فایل destinationFileName ممنوع است.

PathTooLongException

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

NotSupportedException

فایل در destinationFileName شامل دو نقطه (:) در وسط رشته است.

SetSource(Stream)

محتوا را برای کدگذاری در داخل آرشیو تنظیم می‌کند.

public void SetSource(Stream source)

پارامترها

source Stream

استریم ورودی برای آرشیو.

مثال‌ها 

using (var archive = new UueArchive()) 
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.uue");
}

SetSource(FileInfo)

محتوا را برای فشرده‌سازی در داخل آرشیو تنظیم می‌کند.

public void SetSource(FileInfo fileInfo)

پارامترها

fileInfo FileInfo

مرجع به فایلی که باید فشرده شود.

مثال‌ها 

using (var archive = new UueArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.uue");
}

SetSource(string)

محتوا را برای کدگذاری در داخل آرشیو تنظیم می‌کند.

public void SetSource(string path)

پارامترها

path string

مسیر فایل برای کدگذاری.

مثال‌ها 

using (var archive = new UueArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.uue");
}

استثناها

ArgumentNullException

path null است.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

دسترسی به فایل path ممنوع است.

PathTooLongException

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

NotSupportedException

فایل در path شامل دو نقطه (:) در وسط رشته است.

 فارسی