Class UueArchive
Namespace: Aspose.Zip.Uue
Assembly: Aspose.Zip.dll (25.1.0)
این کلاس نمایانگر فایل uuencoded است.
public class UueArchive : IArchive, IDisposable, IArchiveFileEntry
وراثت
پیادهسازیها
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 مراجعه کنید.
استثناها
path
null است.
فراخواننده مجوز لازم برای دسترسی را ندارد.
path
خالی است، فقط شامل فضای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل path
ممنوع است.
path
، نام فایل، یا هر دو طولی بیشتر از حداکثر طول تعریفشده توسط سیستم دارند. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشند.
فایل در path
شامل دو نقطه (:) در وسط رشته است.
ویژگیها
Name
نام فایل اصلی.
public string Name { get; }
مقدار ویژگی
متدها
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);
}
استثناها
destination
از نوشتن پشتیبانی نمیکند.
Extract(string)
آرشیو را به فایل با مسیر استخراج میکند.
public FileInfo Extract(string path)
پارامترها
path
string
مسیر به فایل مقصد. اگر فایل از قبل وجود داشته باشد، بازنویسی خواهد شد.
بازگشت
اطلاعات فایل استخراجشده.
استثناها
path
null است.
فراخواننده مجوز لازم برای دسترسی را ندارد.
path
خالی است، فقط شامل فضای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل path
ممنوع است.
path
، نام فایل، یا هر دو طولی بیشتر از حداکثر طول تعریفشده توسط سیستم دارند. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشند.
فایل در path
شامل دو نقطه (:) در وسط رشته است.
فایل پیدا نشد.
مسیر مشخصشده نامعتبر است، مانند اینکه در یک درایو غیرنقشهبرداری باشد.
فایل از قبل باز است.
ExtractToDirectory(string)
محتویات آرشیو را به دایرکتوری ارائهشده استخراج میکند.
public void ExtractToDirectory(string destinationDirectory)
پارامترها
destinationDirectory
string
مسیر به دایرکتوری برای قرار دادن فایلهای استخراجشده.
توضیحات
اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.
استثناها
destinationDirectory
null است.
path
، نام فایل، یا هر دو طولی بیشتر از حداکثر طول تعریفشده توسط سیستم دارند. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشند.
فراخواننده مجوز لازم برای دسترسی به دایرکتوری موجود را ندارد.
اگر دایرکتوری وجود نداشته باشد، مسیر شامل کاراکتر دو نقطه (:) باشد که بخشی از برچسب درایو نیست (“C:") باشد.
destinationDirectory
یک رشته با طول صفر است، فقط شامل فضای خالی است، یا شامل یک یا چند کاراکتر نامعتبر است. میتوانید برای جستجوی کاراکترهای نامعتبر از متد System.IO.Path.GetInvalidPathChars استفاده کنید.
-یا- مسیر با کاراکتر دو نقطه (:) شروع میشود یا فقط شامل کاراکتر دو نقطه است.
دایرکتوری مشخصشده توسط مسیر یک فایل است. -یا- نام شبکه شناخته نشده است.
Open()
آرشیو را برای رمزگشایی باز میکند و یک استریم با محتوای آرشیو ارائه میدهد.
public Stream Open()
بازگشت
استریم که محتوای آرشیو را نمایان میکند.
مثالها
استفاده:
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
باید قابل نوشتن باشد.
استثناها
منبع دادهای که باید آرشیو شود، ارائه نشده است.
outputStream
قابل نوشتن نیست.
منبع فایل فقط خواندنی است یا یک دایرکتوری است.
مسیر منبع فایل مشخصشده نامعتبر است، مانند اینکه در یک درایو غیرنقشهبرداری باشد.
منبع فایل از قبل باز است.
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");
}
استثناها
destinationFileName
null است.
فراخواننده مجوز لازم برای دسترسی را ندارد.
destinationFileName
خالی است، فقط شامل فضای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل destinationFileName
ممنوع است.
destinationFileName
، نام فایل، یا هر دو طولی بیشتر از حداکثر طول تعریفشده توسط سیستم دارند. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشند.
فایل در 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");
}
استثناها
path
null است.
فراخواننده مجوز لازم برای دسترسی را ندارد.
path
خالی است، فقط شامل فضای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل path
ممنوع است.
path
، نام فایل، یا هر دو طولی بیشتر از حداکثر طول تعریفشده توسط سیستم دارند. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشند.
فایل در path
شامل دو نقطه (:) در وسط رشته است.