Class UueArchive

Class UueArchive

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

המחלקה הזו מייצגת קובץ מקודד ב-uu.

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()

דוגמאות

דוגמה הבאה מראה כיצד לקודד קובץ ב-uu.

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

הנתיב, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות 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

הנתיב, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות 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();

.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, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות 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 מכיל נקודתיים (:) באמצע המחרוזת.

 Ελληνικά