Class UueArchive

path הוא null.

המבצע אינו מחזיק בהרשאה הנדרשת לגישה.

path ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.

גישה לקובץ path נדחתה.

הנתיב, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, הנתיבים חייבים להיות פחות מ-248 תווים, ושמות הקבצים חייבים להיות פחות מ-260 תווים.

הקובץ ב-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);
}

חריגות

destination אינו תומך בכתיבה.

Extract(string)

מוציא את הארכיון לקובץ לפי נתיב.

public FileInfo Extract(string path)

פרמטרים

path string

הנתיב לקובץ היעד. אם הקובץ כבר קיים, הוא יוחלף.

מחזיר

FileInfo

מידע על הקובץ המוצא.

חריגות

path הוא null.

המבצע אינו מחזיק בהרשאה הנדרשת לגישה.

path ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.

גישה לקובץ path נדחתה.

DirectoryNotFoundException

הקובץ ב-path מכיל נקודתיים (:) באמצע המחרוזת.

FileNotFoundException

הקובץ לא נמצא.

הנתיב שנבחר אינו חוקי, כמו למשל כשמדובר בכונן שאינו ממופה.

IOException

הקובץ כבר פתוח.

ExtractToDirectory(string)

מוציא את תוכן הארכיון לתיקייה המסופקת.

public void ExtractToDirectory(string destinationDirectory)

פרמטרים

destinationDirectory string

הנתיב לתיקייה שבה יונחו הקבצים המוצאים.

הערות

אם התיקייה אינה קיימת, היא תיווצר.

חריגות

destinationDirectory הוא null.

הנתיב, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, הנתיבים חייבים להיות פחות מ-248 תווים ושמות הקבצים חייבים להיות פחות מ-260 תווים.

המבצע אינו מחזיק בהרשאה הנדרשת לגישה לתיקייה הקיימת.

אם התיקייה אינה קיימת, הנתיב מכיל תו נקודתיים (:) שאינו חלק מתווית הכונן (“C:").

InvalidOperationException

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 &lt; (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 אינו ניתן לכתיבה.

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");
}

חריגות

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 תווים.