Class UueArchive
Namespace: Aspose.Zip.Uue
Assembly: Aspose.Zip.dll (25.1.0)
המחלקה הזו מייצגת קובץ מקודד ב-uu.
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()
דוגמאות
דוגמה הבאה מראה כיצד לקודד קובץ ב-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 לפענוח.
חריגות
path
הוא null.
המבצע אינו מחזיק בהרשאה הנדרשת לגישה.
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
נדחתה.
הנתיב, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות 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();
.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
, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות 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
מכיל נקודתיים (:) באמצע המחרוזת.