Class Bzip2Archive

Class Bzip2Archive

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

כיתה זו מייצגת קובץ ארכיון bzip2. השתמש בה כדי להרכיב או לחלץ ארכיונים ב-bzip2.

public class Bzip2Archive : IArchive, IDisposable, IArchiveFileEntry

ירושה

object ← Bzip2Archive

מיישם

IArchive, IDisposable, IArchiveFileEntry

חברי ירושה

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

הערות

bzip2 דוחס קבצים באמצעות אלגוריתם דחיסת טקסט מיון בלוק של בורוז-ווילר וקידוד Huffman. ראה עוד: https://en.wikipedia.org/wiki/Bzip2

בונים

Bzip2Archive()

מאתחל מופע חדש של הכיתה Aspose.Zip.Bzip2.Bzip2Archive שהוכן לדחיסה.

public Bzip2Archive()

דוגמאות

הדוגמה הבאה מראה כיצד לדחוס קובץ.

using (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.bz2");
}

Bzip2Archive(Stream, Bzip2LoadOptions)

מאתחל מופע חדש של הכיתה Aspose.Zip.Bzip2.Bzip2Archive שהוכן לדחיסה.

public Bzip2Archive(Stream sourceStream, Bzip2LoadOptions loadOptions = null)

פרמטרים

sourceStream Stream

מקור הארכיון.

loadOptions Bzip2LoadOptions

האפשרויות לטעינת הארכיון.

דוגמאות

פתח ארכיון מזרם וחלץ אותו לMemoryStream

var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive(File.OpenRead("archive.bz2")))
  archive.Open().CopyTo(ms);

הערות

בונה זה אינו מחלץ. ראה את שיטת Aspose.Zip.Bzip2.Bzip2Archive.Open לחילוץ.

Bzip2Archive(string, Bzip2LoadOptions)

מאתחל מופע חדש של הכיתה Aspose.Zip.Bzip2.Bzip2Archive שהוכן לחילוץ.

public Bzip2Archive(string path, Bzip2LoadOptions loadOptions = null)

פרמטרים

path string

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

loadOptions Bzip2LoadOptions

האפשרויות לטעינת הארכיון.

דוגמאות

פתח ארכיון מקובץ לפי נתיב וחלץ אותו לMemoryStream

var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
  archive.Open().CopyTo(ms);

הערות

בונה זה אינו מחלץ. ראה את שיטת Aspose.Zip.Bzip2.Bzip2Archive.Open לחילוץ.

חריגות

ArgumentNullException

path הוא null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

שיטות

Dispose()

מבצע משימות שהוגדרו על ידי היישום הקשורות לשחרור, שחרור או איפוס של משאבים לא מנוהלים.

public void Dispose()

Dispose(bool)

מבצע משימות שהוגדרו על ידי היישום הקשורות לשחרור, שחרור או איפוס של משאבים לא מנוהלים.

protected virtual void Dispose(bool disposing)

פרמטרים

disposing bool

האם יש לשחרר משאבים מנוהלים.

Extract(Stream)

מחלץ את הארכיון לזרם שסופק.

public void Extract(Stream destination)

פרמטרים

destination Stream

זרם יעד. חייב להיות ניתן לכתיבה.

דוגמאות 

using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
{
     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();

.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_Bzip2_Bzip2Archive_Save_System_IO_Stream_Aspose_Zip_Bzip2_Bzip2SaveOptions_"></a> Save\(Stream, Bzip2SaveOptions\)

שומר את הארכיון לזרם שסופק.

```csharp
public void Save(Stream outputStream, Bzip2SaveOptions saveOptions = null)

פרמטרים

outputStream Stream

זרם יעד.

saveOptions Bzip2SaveOptions

אפשרויות לשמירת ארכיון bzip2. אם לא צוין, גודל הבלוק יהיה 900 קילובייט.

דוגמאות

כותב נתוני דחיסה לזרם התגובה של http.

using (var archive = new Bzip2Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

הערות

outputStream חייב להיות ניתן לכתיבה.

חריגות

InvalidOperationException

מקור הנתונים שצריך לארכב לא סופק.

ArgumentException

outputStream אינו ניתן לכתיבה.

UnauthorizedAccessException

מקור הקובץ הוא לקריאה בלבד או שהוא תיקייה.

DirectoryNotFoundException

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

IOException

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

Save(string, Bzip2SaveOptions)

שומר את הארכיון לקובץ היעד שסופק.

public void Save(string destinationFileName, Bzip2SaveOptions saveOptions = null)

פרמטרים

destinationFileName string

הנתיב של הארכיון שצריך להיווצר. אם שם הקובץ שצוין מצביע על קובץ קיים, הוא יוחלף.

saveOptions Bzip2SaveOptions

אפשרויות לשמירת ארכיון bzip2. אם לא צוין, גודל הבלוק יהיה 900 קילובייט.

דוגמאות

כותב נתוני דחיסה לקובץ.

using (var archive = new Bzip2Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bz2");
}

חריגות

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 (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00,0xFF }));
    archive.Save("archive.bz2");
}

SetSource(FileInfo)

מגדיר את התוכן שצריך לדחוס בתוך הארכיון.

public void SetSource(FileInfo fileInfo)

פרמטרים

fileInfo FileInfo

ההפניה לקובץ שצריך לדחוס.

דוגמאות 

using (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.bz2");
}

SetSource(string)

מגדיר את התוכן שצריך לדחוס בתוך הארכיון.

public void SetSource(string path)

פרמטרים

path string

נתיב לקובץ שצריך לדחוס.

דוגמאות 

using (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.bz2");
}

חריגות

ArgumentNullException

path הוא null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

SetSource(TarArchive, TarFormat)

מגדיר את התוכן שצריך לדחוס בתוך הארכיון.

public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)

פרמטרים

tarArchive TarArchive

ארכיון Tar שצריך לדחוס.

format TarFormat

מגדיר את פורמט הכותרת של tar.

דוגמאות 

using (var tarArchive = new TarArchive())
{
    tarArchive.CreateEntry("first.bin", "data1.bin");
    tarArchive.CreateEntry("second.bin", "data2.bin");
    using (var bzippedArchive = new Bzip2Archive())
    {
        bzippedArchive.SetSource(tarArchive);
        bzippedArchive.Save("archive.tar.bz2");
    }
}

הערות

השתמש בשיטה זו כדי להרכיב ארכיון tar.bz2 משולב.

SetSource(CpioArchive, CpioFormat)

מגדיר את התוכן שצריך לדחוס בתוך הארכיון.

public void SetSource(CpioArchive cpioArchive, CpioFormat format = CpioFormat.OldAscii)

פרמטרים

cpioArchive CpioArchive

ארכיון Cpio שצריך לדחוס.

format CpioFormat

מגדיר את פורמט הכותרת של cpio.

דוגמאות 

using (var cpioArchive = new CpioArchive())
{
    cpioArchive.CreateEntry("first.bin", "data1.bin");
    cpioArchive.CreateEntry("second.bin", "data2.bin");
    using (var bzippedArchive = new Bzip2Archive())
    {
        bzippedArchive.SetSource(cpioArchive);
        bzippedArchive.Save("archive.cpio.bz2");
    }
}

הערות

השתמש בשיטה זו כדי להרכיב ארכיון cpio.bz2 משולב.

 Ελληνικά