Class SnappyArchive

Class SnappyArchive

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

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

public class SnappyArchive : IArchive, IDisposable, IArchiveFileEntry

ירושה

objectSnappyArchive

מיישם

IArchive, IDisposable, IArchiveFileEntry

חברים שהורשו

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

בונים

SnappyArchive()

מאתחל מופע חדש של מחלקת Aspose.Zip.Snappy.SnappyArchive המוכן לדחיסה.

public SnappyArchive()

דוגמאות

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

using (SnappyArchive archive = new SnappyArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.snapy");
}

SnappyArchive(Stream)

מאתחל מופע חדש של מחלקת Aspose.Zip.Snappy.SnappyArchive המוכן לפריקה.

public SnappyArchive(Stream source)

פרמטרים

source Stream

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

הערות

בונה זה אינו מפרק. ראה את המתודה Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) לפריקה.

חריגים

ArgumentException

source אינו ניתן לחיפוש.

ArgumentNullException

source הוא null.

SnappyArchive(string)

מאתחל מופע חדש של מחלקת Aspose.Zip.Snappy.SnappyArchive המוכן לפריקה.

public SnappyArchive(string path)

פרמטרים

path string

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

דוגמאות

using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
    using (var archive = new SnappyArchive(sourceSnappyFile))
    {
         archive.Extract(extractedFile);
    }
   }

הערות

בונה זה אינו מפרק. ראה את המתודה Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) לפריקה.

חריגים

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)

מפרק ארכיון Snappy לזרם.

public void Extract(Stream destination)

פרמטרים

destination Stream

זרם לאחסון נתונים מפורקים.

דוגמאות

using (FileStream sourceSnappyFile = File.Open(sourceFileName, FileMode.Open))
{
   using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
   {
       using (var archive = new SnappyArchive(sourceSnappyFile))
       {
           archive.Extract(extractedFile);
       }
   }
}

חריגים

InvalidOperationException

כותרות הארכיון ומידע השירות לא נקראו.

InvalidDataException

שגיאה בנתונים בכותרת או ב-checksum.

ArgumentNullException

זרם היעד הוא null.

ArgumentException

זרם היעד אינו תומך בכתיבה.

Extract(FileInfo)

מפרק ארכיון Snappy לקובץ.

public void Extract(FileInfo fileInfo)

פרמטרים

fileInfo FileInfo

FileInfo לאחסון נתונים מפורקים.

דוגמאות

using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new SnappyArchive(snappyFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

חריגים

InvalidOperationException

כותרות הארכיון ומידע השירות לא נקראו.

SecurityException

לקרוא אין הרשאה נדרשת לפתוח את fileInfo.

ArgumentException

נתיב הקובץ ריק או מכיל רק רווחים.

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo הוא null.

DirectoryNotFoundException

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

IOException

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

Extract(string)

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

public FileInfo Extract(string path)

פרמטרים

path string

נתיב לקובץ שיאחסן נתונים מפורקים.

מחזיר

FileInfo

אינסטנציה של System.IO.FileInfo המכילה נתונים מפורקים.

דוגמאות

using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new SnappyArchive(snappyFile))
    {
        archive.Extract("extracted.bin");
    }
}

חריגים

InvalidOperationException

כותרות הארכיון ומידע השירות לא נקראו.

ArgumentNullException

path הוא null.

SecurityException

לקרוא אין הרשאה נדרשת לגישה.

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

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

התיקיה שניתנה על ידי הנתיב היא קובץ. -או- שם הרשת אינו ידוע.

Save(Stream)

שומר את הארכיון של Snappy לזרם שניתן.

public void Save(Stream output)

פרמטרים

output Stream

זרם היעד.

דוגמאות

using (FileStream snappyFile = File.Open("archive.snappy", FileMode.Create))
{
    using (var archive = new SnappyArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(snappyFile);
     }
}

הערות

output חייב להיות ניתן לחיפוש.

חריגים

ArgumentException

output אינו תומך בחיפוש.

ArgumentNullException

output הוא null.

Save(FileInfo)

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

public void Save(FileInfo destination)

פרמטרים

destination FileInfo

FileInfo שייפתח כזרם יעד.

דוגמאות

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

חריגים

SecurityException

לקרוא אין הרשאה נדרשת לפתוח את destination.

ArgumentException

נתיב הקובץ ריק או מכיל רק רווחים.

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

destination הוא null.

DirectoryNotFoundException

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

IOException

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

Save(string)

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

public void Save(string destinationFileName)

פרמטרים

destinationFileName string

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

דוגמאות

using (var archive = new SnappyArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.snappy");
}

חריגים

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

חריגים

ArgumentException

זרם source אינו ניתן לחיפוש.

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

פרמטרים

fileInfo FileInfo

FileInfo שייפתח כזרם קלט.

דוגמאות

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

חריגים

SecurityException

לקרוא אין הרשאה נדרשת לפתוח את fileInfo.

ArgumentException

נתיב הקובץ ריק או מכיל רק רווחים.

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo הוא null.

DirectoryNotFoundException

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

IOException

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

SetSource(string)

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

public void SetSource(string sourcePath)

פרמטרים

sourcePath string

נתיב לקובץ שייפתח כזרם קלט.

דוגמאות

using (var archive = new SnappyArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.snappy");
}

חריגים

ArgumentNullException

sourcePath הוא null.

SecurityException

לקרוא אין הרשאה נדרשת לגישה.

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 Ελληνικά