Class UueArchive

Class UueArchive

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

تمثل هذه الفئة ملفًا مشفرًا باستخدام طريقة uuencoding.

public class UueArchive : IArchive, IDisposable, IArchiveFileEntry

الوراثة

objectUueArchive

التنفيذ

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، اسم الملف، أو كليهما يتجاوزان الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على الأنظمة المستندة إلى Windows، يجب أن تكون المسارات أقل من 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، اسم الملف، أو كليهما يتجاوزان الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على الأنظمة المستندة إلى Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.

NotSupportedException

الملف في path يحتوي على نقطتين (:) في منتصف السلسلة.

FileNotFoundException

الملف غير موجود.

DirectoryNotFoundException

المسار المحدد غير صالح، مثل أن يكون على محرك غير مخصص.

IOException

الملف مفتوح بالفعل.

ExtractToDirectory(string)

يستخرج محتوى الأرشيف إلى الدليل المقدم.

public void ExtractToDirectory(string destinationDirectory)

المعلمات

destinationDirectory string

المسار إلى الدليل لوضع الملفات المستخرجة فيه.

ملاحظات

إذا لم يكن الدليل موجودًا، فسيتم إنشاؤه.

الاستثناءات

ArgumentNullException

destinationDirectory هو null.

PathTooLongException

المسار المحدد، اسم الملف، أو كليهما يتجاوزان الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على الأنظمة المستندة إلى Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.

SecurityException

المستدعي ليس لديه الإذن المطلوب للوصول إلى الدليل الموجود.

NotSupportedException

إذا لم يكن الدليل موجودًا، يحتوي المسار على حرف نقطتين (:) ليس جزءًا من تسمية محرك (“C:").

ArgumentException

destinationDirectory هو سلسلة بطول صفر، يحتوي فقط على مسافات بيضاء، أو يحتوي على حرف واحد أو أكثر غير صالحة. يمكنك الاستعلام عن الأحرف غير الصالحة باستخدام الطريقة System.IO.Path.GetInvalidPathChars. -أو- المسار مُسبق بـ، أو يحتوي فقط على حرف نقطتين (:).

IOException

الدليل المحدد بواسطة المسار هو ملف. -أو- اسم الشبكة غير معروف.

Open()

يفتح الأرشيف لفك التشفير ويوفر دفقًا بمحتويات الأرشيف.

public Stream Open()

العائدات

Stream

الدفق الذي يمثل محتويات الأرشيف.

أمثلة

الاستخدام: Stream decompressed = archive.Open();

.نت 4.0 وما فوق - استخدم طريقة Stream.CopyTo: decompressed.CopyTo(httpResponse.OutputStream)

.نت 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، اسم الملف، أو كليهما يتجاوزان الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على الأنظمة المستندة إلى Windows، يجب أن تكون المسارات أقل من 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، اسم الملف، أو كليهما يتجاوزان الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على الأنظمة المستندة إلى Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.

NotSupportedException

الملف في path يحتوي على نقطتين (:) في منتصف السلسلة.

 عربي