Class UueArchive
Namespace: Aspose.Zip.Uue
Assembly: Aspose.Zip.dll (25.1.0)
تمثل هذه الفئة ملفًا مشفرًا باستخدام طريقة uuencoding.
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
، اسم الملف، أو كليهما يتجاوزان الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على الأنظمة المستندة إلى Windows، يجب أن تكون المسارات أقل من 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
، اسم الملف، أو كليهما يتجاوزان الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على الأنظمة المستندة إلى Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
الملف في path
يحتوي على نقطتين (:) في منتصف السلسلة.
الملف غير موجود.
المسار المحدد غير صالح، مثل أن يكون على محرك غير مخصص.
الملف مفتوح بالفعل.
ExtractToDirectory(string)
يستخرج محتوى الأرشيف إلى الدليل المقدم.
public void ExtractToDirectory(string destinationDirectory)
المعلمات
destinationDirectory
string
المسار إلى الدليل لوضع الملفات المستخرجة فيه.
ملاحظات
إذا لم يكن الدليل موجودًا، فسيتم إنشاؤه.
الاستثناءات
destinationDirectory
هو null.
المسار المحدد، اسم الملف، أو كليهما يتجاوزان الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على الأنظمة المستندة إلى Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
المستدعي ليس لديه الإذن المطلوب للوصول إلى الدليل الموجود.
إذا لم يكن الدليل موجودًا، يحتوي المسار على حرف نقطتين (:) ليس جزءًا من تسمية محرك (“C:").
destinationDirectory
هو سلسلة بطول صفر، يحتوي فقط على مسافات بيضاء، أو يحتوي على حرف واحد أو أكثر غير صالحة. يمكنك الاستعلام عن الأحرف غير الصالحة باستخدام الطريقة System.IO.Path.GetInvalidPathChars.
-أو- المسار مُسبق بـ، أو يحتوي فقط على حرف نقطتين (:).
الدليل المحدد بواسطة المسار هو ملف. -أو- اسم الشبكة غير معروف.
Open()
يفتح الأرشيف لفك التشفير ويوفر دفقًا بمحتويات الأرشيف.
public Stream Open()
العائدات
الدفق الذي يمثل محتويات الأرشيف.
أمثلة
الاستخدام:
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
يجب أن يكون قابلًا للكتابة.
الاستثناءات
لم يتم توفير مصدر البيانات ليتم أرشفته.
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
، اسم الملف، أو كليهما يتجاوزان الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على الأنظمة المستندة إلى Windows، يجب أن تكون المسارات أقل من 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
، اسم الملف، أو كليهما يتجاوزان الطول الأقصى المحدد من قبل النظام. على سبيل المثال، على الأنظمة المستندة إلى Windows، يجب أن تكون المسارات أقل من 248 حرفًا، ويجب أن تكون أسماء الملفات أقل من 260 حرفًا.
الملف في path
يحتوي على نقطتين (:) في منتصف السلسلة.