Class SnappyArchive
Namespace: Aspose.Zip.Snappy
Assembly: Aspose.Zip.dll (25.1.0)
מחלקה זו מייצגת קובץ ארכיון Snappy. השתמש בה כדי להרכיב או לחלץ ארכיונים של Snappy.
public class SnappyArchive : 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()
בונים
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) לפריקה.
חריגים
source
אינו ניתן לחיפוש.
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) לפריקה.
חריגים
path
הוא null.
לקרוא אין הרשאה נדרשת לגישה.
path
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
גישה לקובץ path
נדחתה.
הpath
, שם הקובץ, או שניהם חורגים מהאורך המקסימלי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, נתיבים חייבים להיות פחות מ-248 תווים, ושמות קבצים חייבים להיות פחות מ-260 תווים.
הקובץ בpath
מכיל נקודתיים (:) באמצע המחרוזת.
הקובץ לא נמצא.
הנתיב שניתן אינו חוקי, כגון היותו בכונן לא ממופה.
הקובץ כבר פתוח.
מתודות
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);
}
}
}
חריגים
כותרות הארכיון ומידע השירות לא נקראו.
שגיאה בנתונים בכותרת או ב-checksum.
זרם היעד הוא null.
זרם היעד אינו תומך בכתיבה.
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"));
}
}
חריגים
כותרות הארכיון ומידע השירות לא נקראו.
לקרוא אין הרשאה נדרשת לפתוח את fileInfo
.
נתיב הקובץ ריק או מכיל רק רווחים.
הקובץ לא נמצא.
הנתיב לקובץ הוא רק לקריאה או שהוא תיקיה.
fileInfo
הוא null.
הנתיב שניתן אינו חוקי, כגון היותו בכונן לא ממופה.
הקובץ כבר פתוח.
Extract(string)
מפרק ארכיון Snappy לקובץ לפי נתיב.
public FileInfo Extract(string path)
פרמטרים
path
string
נתיב לקובץ שיאחסן נתונים מפורקים.
מחזיר
אינסטנציה של System.IO.FileInfo המכילה נתונים מפורקים.
דוגמאות
using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new SnappyArchive(snappyFile))
{
archive.Extract("extracted.bin");
}
}
חריגים
כותרות הארכיון ומידע השירות לא נקראו.
path
הוא null.
לקרוא אין הרשאה נדרשת לגישה.
הpath
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
גישה לקובץ 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.
-או- הנתיב מקדים, או מכיל, רק תו נקודתיים (:).
התיקיה שניתנה על ידי הנתיב היא קובץ. -או- שם הרשת אינו ידוע.
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
חייב להיות ניתן לחיפוש.
חריגים
output
אינו תומך בחיפוש.
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"));
}
חריגים
לקרוא אין הרשאה נדרשת לפתוח את destination
.
נתיב הקובץ ריק או מכיל רק רווחים.
הקובץ לא נמצא.
הנתיב לקובץ הוא רק לקריאה או שהוא תיקיה.
destination
הוא null.
הנתיב שניתן אינו חוקי, כגון היותו בכונן לא ממופה.
הקובץ כבר פתוח.
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");
}
חריגים
destinationFileName
הוא null.
לקרוא אין הרשאה נדרשת לגישה.
הdestinationFileName
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
גישה לקובץ destinationFileName
נדחתה.
הdestinationFileName
, שם הקובץ, או שניהם חורגים מהאורך המקסימלי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, נתיבים חייבים להיות פחות מ-248 תווים, ושמות קבצים חייבים להיות פחות מ-260 תווים.
הקובץ ב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");
}
חריגים
זרם 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");
}
חריגים
לקרוא אין הרשאה נדרשת לפתוח את fileInfo
.
נתיב הקובץ ריק או מכיל רק רווחים.
הקובץ לא נמצא.
הנתיב לקובץ הוא רק לקריאה או שהוא תיקיה.
fileInfo
הוא null.
הנתיב שניתן אינו חוקי, כגון היותו בכונן לא ממופה.
הקובץ כבר פתוח.
SetSource(string)
מגדיר את התוכן שידחס בתוך הארכיון.
public void SetSource(string sourcePath)
פרמטרים
sourcePath
string
נתיב לקובץ שייפתח כזרם קלט.
דוגמאות
using (var archive = new SnappyArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.snappy");
}
חריגים
sourcePath
הוא null.
לקרוא אין הרשאה נדרשת לגישה.
הsourcePath
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
גישה לקובץ sourcePath
נדחתה.
הsourcePath
, שם הקובץ, או שניהם חורגים מהאורך המקסימלי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, נתיבים חייבים להיות פחות מ-248 תווים, ושמות קבצים חייבים להיות פחות מ-260 תווים.
הקובץ בsourcePath
מכיל נקודתיים (:) באמצע המחרוזת.