Class TarArchive
Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)
מחלקה זו מייצגת קובץ ארכיון tar. השתמש בה כדי להרכיב, לחלץ או לעדכן ארכיונים של tar.
public class TarArchive : IArchive, IDisposable
ירושה
מיישם
חברים ירושים
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
בונים
TarArchive()
מאתחל מופע חדש של מחלקת Aspose.Zip.Tar.TarArchive.
public TarArchive()
דוגמאות
הדוגמה הבאה מראה כיצד לדחוס קובץ.
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.tar");
}
TarArchive(Stream)
מאתחל מופע חדש של מחלקת Aspose.Zip.Archive ומרכיב רשימת פריטים שניתן לחלץ מהארכיון.
public TarArchive(Stream sourceStream)
פרמטרים
sourceStream
Stream
מקור הארכיון. עליו להיות ניתן לחיפוש.
דוגמאות
הדוגמה הבאה מראה כיצד לחלץ את כל הפריטים לתיקיה.
using (var archive = new TarArchive(File.OpenRead("archive.tar")))
{
archive.ExtractToDirectory("C:\extracted");
}
הערות
בונה זה אינו פורק אף פריט. ראה את שיטת Aspose.Zip.Tar.TarEntry.Open לפירוק.
חריגות
sourceStream
אינו ניתן לחיפוש.
TarArchive(string)
מאתחל מופע חדש של מחלקת Aspose.Zip.Tar.TarArchive ומרכיב רשימת פריטים שניתן לחלץ מהארכיון.
public TarArchive(string path)
פרמטרים
path
string
הנתיב לקובץ הארכיון.
דוגמאות
הדוגמה הבאה מראה כיצד לחלץ את כל הפריטים לתיקיה.
using (var archive = new TarArchive("archive.tar"))
{
archive.ExtractToDirectory("C:\extracted");
}
הערות
בונה זה אינו פורק אף פריט. ראה את שיטת Aspose.Zip.Tar.TarEntry.Open לפירוק.
חריגות
path
הוא null.
ה caller אינו בעל ההרשאה הנדרשת לגישה.
ה path
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים.
גישה לקובץ path
נדחתה.
ה path
, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, הנתיבים חייבים להיות פחות מ-248 תווים, ושמות הקבצים חייבים להיות פחות מ-260 תווים.
הקובץ ב path
מכיל נקודתיים (:) באמצע המחרוזת.
הקובץ לא נמצא.
הנתיב המצויין אינו חוקי, כמו לדוגמה, כאשר הוא נמצא בכונן שאינו ממופה.
הקובץ כבר פתוח.
מאפיינים
Entries
מקבל את הפריטים מסוג Aspose.Zip.Tar.TarEntry המהווים את הארכיון.
public ReadOnlyCollection<tarentry> Entries { get; }
ערך המאפיין
ReadOnlyCollection<TarEntry>
שיטות
CreateEntries(DirectoryInfo, bool)
מוסיף לארכיון את כל הקבצים והתיקיות באופן רקורסיבי בתיקיה הנתונה.
public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)
פרמטרים
directory
DirectoryInfo
תיקיה לדחיסה.
includeRootDirectory
bool
מציין אם לכלול את התיקיה הראשית עצמה או לא.
מחזיר
הארכיון עם הפריטים המרכיבים.
דוגמאות
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
archive.Save(tarFile);
}
}
CreateEntries(string, bool)
מוסיף לארכיון את כל הקבצים והתיקיות באופן רקורסיבי בתיקיה הנתונה.
public TarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)
פרמטרים
sourceDirectory
string
תיקיה לדחיסה.
includeRootDirectory
bool
מציין אם לכלול את התיקיה הראשית עצמה או לא.
מחזיר
הארכיון עם הפריטים המרכיבים.
דוגמאות
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntries("C:\folder", false);
archive.Save(tarFile);
}
}
חריגות
sourceDirectory
הוא null.
ה caller אינו בעל ההרשאה הנדרשת לגישה ל sourceDirectory
.
sourceDirectory
מכיל תווים לא חוקיים כמו “, <, >, או |.
הנתיב, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, הנתיבים חייבים להיות פחות מ-248 תווים, ושמות הקבצים חייבים להיות פחות מ-260 תווים. הנתיב, שם הקובץ, או שניהם ארוכים מדי.
CreateEntry(string, Stream, FileSystemInfo)
יוצר פריט בודד בתוך הארכיון.
public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
פרמטרים
name
string
שם הפריט.
source
Stream
הזרם הקלט עבור הפריט.
fileInfo
FileSystemInfo
מטא-מידע של קובץ או תיקיה שיש לדחוס.
מחזיר
מופע של פריט tar.
דוגמאות
using (var archive = new TarArchive())
{
archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
archive.Save(tarFile);
}
הערות
שם הפריט נקבע אך ורק בפרמטר name
. שם הקובץ שניתן בפרמטר fileInfo
אינו משפיע על שם הפריט.
fileInfo
יכול להתייחס ל- System.IO.DirectoryInfo אם הפריט הוא תיקיה.
חריגות
name
ארוך מדי עבור tar לפי תקן IEEE 1003.1-1998.
שם הקובץ, כחלק מ-name
, חורג מ-100 תווים.
CreateEntry(string, FileInfo, bool)
יוצר פריט בודד בתוך הארכיון.
public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
פרמטרים
name
string
שם הפריט.
fileInfo
FileInfo
מטא-מידע של קובץ או תיקיה שיש לדחוס.
openImmediately
bool
נכון אם יש לפתוח את הקובץ מיד, אחרת יש לפתוח את הקובץ בעת שמירת הארכיון.
מחזיר
מופע של פריט tar.
דוגמאות
FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
archive.CreateEntry("data.bin", fi);
archive.Save(tarFile);
}
הערות
שם הפריט נקבע אך ורק בפרמטר name
. שם הקובץ שניתן בפרמטר fileInfo
אינו משפיע על שם הפריט.
fileInfo
יכול להתייחס ל- System.IO.DirectoryInfo אם הפריט הוא תיקיה.
אם הקובץ נפתח מיד עם פרמטר openImmediately
, הוא חסום עד שהארכיון יושלך.
חריגות
name
ארוך מדי עבור tar לפי תקן IEEE 1003.1-1998.
שם הקובץ, כחלק מ-name
, חורג מ-100 תווים.
CreateEntry(string, string, bool)
יוצר פריט בודד בתוך הארכיון.
public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
פרמטרים
name
string
שם הפריט.
path
string
נתיב לקובץ שיש לדחוס.
openImmediately
bool
נכון אם יש לפתוח את הקובץ מיד, אחרת יש לפתוח את הקובץ בעת שמירת הארכיון.
מחזיר
מופע של פריט tar.
דוגמאות
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save(outputTarFile);
}
הערות
שם הפריט נקבע אך ורק בפרמטר name
. שם הקובץ שניתן בפרמטר path
אינו משפיע על שם הפריט.
אם הקובץ נפתח מיד עם פרמטר openImmediately
, הוא חסום עד שהארכיון יושלך.
חריגות
path
הוא null.
ה caller אינו בעל ההרשאה הנדרשת לגישה.
ה path
ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים. - או - שם הקובץ, כחלק מ-name
, חורג מ-100 תווים.
גישה לקובץ path
נדחתה.
ה path
, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, הנתיבים חייבים להיות פחות מ-248 תווים, ושמות הקבצים חייבים להיות פחות מ-260 תווים. - או - name
ארוך מדי עבור tar לפי תקן IEEE 1003.1-1998.
הקובץ ב path
מכיל נקודתיים (:) באמצע המחרוזת.
DeleteEntry(TarEntry)
מסיר את ההתרחשות הראשונה של פריט ספציפי מרשימת הפריטים.
public TarArchive DeleteEntry(TarEntry entry)
פרמטרים
entry
TarEntry
הפריט להסרה מרשימת הפריטים.
מחזיר
הארכיון עם הפריט שנמחק.
דוגמאות
הנה איך אתה יכול להסיר את כל הפריטים מלבד האחרון:
using (var archive = new TarArchive("archive.tar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries[0]);
archive.Save(outputTarFile);
}
DeleteEntry(int)
מסיר את הפריט מרשימת הפריטים לפי אינדקס.
public TarArchive DeleteEntry(int entryIndex)
פרמטרים
entryIndex
int
האינדקס של הפריט להסרה.
מחזיר
הארכיון עם הפריט שנמחק.
דוגמאות
using (var archive = new TarArchive("two_files.tar"))
{
archive.DeleteEntry(0);
archive.Save("single_file.tar");
}
חריגות
entryIndex
הוא פחות מ-0.-או- entryIndex
שווה או גדול מ-Entries
count.
Dispose()
מבצע משימות מוגדרות על ידי היישום הקשורות לשחרור, שחרור או איפוס של משאבים לא מנוהלים.
public void Dispose()
Dispose(bool)
מבצע משימות מוגדרות על ידי היישום הקשורות לשחרור, שחרור או איפוס של משאבים לא מנוהלים.
protected virtual void Dispose(bool disposing)
פרמטרים
disposing
bool
אם משאבים מנוהלים צריכים להיות משוחררים.
ExtractToDirectory(string)
חולץ את כל הקבצים בארכיון לתיקיה המסופקת.
public void ExtractToDirectory(string destinationDirectory)
פרמטרים
destinationDirectory
string
הנתיב לתיקיה שבה יש לשים את הקבצים שהחולצו.
דוגמאות
using (var archive = new TarArchive("archive.tar"))
{
archive.ExtractToDirectory("C:\extracted");
}
הערות
אם התיקיה אינה קיימת, היא תיווצר.
חריגות
path הוא null
הנתיב, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, הנתיבים חייבים להיות פחות מ-248 תווים ושמות הקבצים חייבים להיות פחות מ-260 תווים.
ה caller אינו בעל ההרשאה הנדרשת לגישה לתיקיה הקיימת.
אם התיקיה אינה קיימת, הנתיב מכיל תו נקודתיים (:) שאינו חלק מתווית כונן (“C:").
הנתיב הוא מחרוזת באורך אפס, מכיל רק רווחים, או מכיל תו לא חוקי אחד או יותר. אתה יכול לשאול על תווים לא חוקיים באמצעות מתודת System.IO.Path.GetInvalidPathChars. -או- הנתיב מקדים, או מכיל, רק תו נקודתיים (:).
התיקיה המצוינת על ידי הנתיב היא קובץ. -או- שם הרשת אינו ידוע.
FromGZip(Stream)
חולץ את הארכיון gzip המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.
חשוב: הארכיון gzip מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.
public static TarArchive FromGZip(Stream source)
פרמטרים
source
Stream
מקור הארכיון.
מחזיר
מופע של Aspose.Zip.Tar.TarArchive
הערות
זרם החילוץ של GZip אינו ניתן לחיפוש מטבעו של אלגוריתם הדחיסה. הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.
חריגות
הארכיון פגום.
FromGZip(string)
חולץ את הארכיון gzip המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.
חשוב: הארכיון gzip מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.
public static TarArchive FromGZip(string path)
פרמטרים
path
string
הנתיב לקובץ הארכיון.
מחזיר
מופע של Aspose.Zip.Tar.TarArchive
הערות
זרם החילוץ של GZip אינו ניתן לחיפוש מטבעו של אלגוריתם הדחיסה. הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.
חריגות
הארכיון פגום.
FromLZMA(Stream)
חולץ את הארכיון LZMA המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.
חשוב: הארכיון LZMA מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.
public static TarArchive FromLZMA(Stream source)
פרמטרים
source
Stream
מקור הארכיון.
מחזיר
מופע של Aspose.Zip.Tar.TarArchive
הערות
זרם החילוץ של LZMA אינו ניתן לחיפוש מטבעו של אלגוריתם הדחיסה. הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.
FromLZMA(string)
חולץ את הארכיון LZMA המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.
חשוב: הארכיון LZMA מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.
public static TarArchive FromLZMA(string path)
פרמטרים
path
string
הנתיב לקובץ הארכיון.
מחזיר
מופע של Aspose.Zip.Tar.TarArchive
הערות
זרם החילוץ של LZMA אינו ניתן לחיפוש מטבעו של אלגוריתם הדחיסה. הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.
FromLZip(Stream)
חולץ את הארכיון lzip המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.
חשוב: הארכיון lzip מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.
public static TarArchive FromLZip(Stream source)
פרמטרים
source
Stream
מקור הארכיון.
מחזיר
מופע של Aspose.Zip.Tar.TarArchive
הערות
זרם החילוץ של lzip אינו ניתן לחיפוש מטבעו של אלגוריתם הדחיסה. הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.
FromLZip(string)
חולץ את הארכיון lzip המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.
חשוב: הארכיון lzip מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.
public static TarArchive FromLZip(string path)
פרמטרים
path
string
הנתיב לקובץ הארכיון.
מחזיר
מופע של Aspose.Zip.Tar.TarArchive
הערות
זרם החילוץ של lzip אינו ניתן לחיפוש מטבעו של אלגוריתם הדחיסה. הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.
FromXz(Stream)
חולץ את הארכיון בפורמט xz המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.
חשוב: הארכיון xz מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.
public static TarArchive FromXz(Stream source)
פרמטרים
source
Stream
מקור הארכיון.
מחזיר
מופע של Aspose.Zip.Tar.TarArchive
הערות
הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.
FromXz(string)
חולץ את הארכיון בפורמט xz המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.
חשוב: הארכיון xz מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.
public static TarArchive FromXz(string path)
פרמטרים
path
string
הנתיב לקובץ הארכיון.
מחזיר
מופע של Aspose.Zip.Tar.TarArchive
הערות
הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.
FromZ(Stream)
חולץ את הארכיון בפורמט Z המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.
חשוב: הארכיון Z מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.
public static TarArchive FromZ(Stream source)
פרמטרים
source
Stream
מקור הארכיון.
מחזיר
מופע של Aspose.Zip.Tar.TarArchive
הערות
הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.
FromZ(string)
חולץ את הארכיון בפורמט Z המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.
חשוב: הארכיון Z מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.
public static TarArchive FromZ(string path)
פרמטרים
path
string
הנתיב לקובץ הארכיון.
מחזיר
מופע של Aspose.Zip.Tar.TarArchive
הערות
הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.
FromZstandard(Stream)
חולץ את הארכיון בפורמט Zstandard המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.
חשוב: הארכיון Zstandard מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.
public static TarArchive FromZstandard(Stream source)
פרמטרים
source
Stream
מקור הארכיון.
מחזיר
מופע של Aspose.Zip.Tar.TarArchive
חריגות
זרם Zstandard פגום או לא ניתן לקריאה.
הנתונים פגומים.
FromZstandard(string)
חולץ את הארכיון בפורמט Zstandard המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.
חשוב: הארכיון Zstandard מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.
public static TarArchive FromZstandard(string path)
פרמטרים
path
string
הנתיב לקובץ הארכיון.
מחזיר
מופע של Aspose.Zip.Tar.TarArchive
חריגות
זרם Zstandard פגום או לא ניתן לקריאה.
הנתונים פגומים.
Save(Stream, TarFormat?)
שומר את הארכיון לזרם המסופק.
public void Save(Stream output, TarFormat? format = null)
פרמטרים
output
Stream
זרם היעד.
format
TarFormat?
מגדיר את פורמט הכותרת של tar. ערך null יתפרש כ-USTar כאשר אפשרי.
דוגמאות
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(tarFile);
}
}
הערות
output
חייב להיות ניתן לכתיבה.
חריגות
output
אינו ניתן לכתיבה. - או - output
הוא אותו זרם שממנו אנו חותכים.
- או -
לא ניתן לשמור את הארכיון בפורמט format
בשל מגבלות הפורמט.
Save(string, TarFormat?)
שומר את הארכיון לקובץ היעד המצויין.
public void Save(string destinationFileName, TarFormat? format = null)
פרמטרים
destinationFileName
string
הנתיב של הארכיון שיתוצר. אם שם הקובץ המצויין מפנה לקובץ קיים, הוא יימחק.
format
TarFormat?
מגדיר את פורמט הכותרת של tar. ערך null יתפרש כ-USTar כאשר אפשרי.
דוגמאות
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("myarchive.tar");
}
הערות
אפשר לשמור ארכיון באותו נתיב שבו הוא נטען ממנו. עם זאת, זה לא מומלץ מכיוון שגישה זו משתמשת בהעתקה לקובץ זמני.
חריגות
destinationFileName
הוא מחרוזת באורך אפס, מכיל רק רווחים, או מכיל תו לא חוקי אחד או יותר כפי שמוגדר על ידי System.IO.Path.InvalidPathChars.
destinationFileName
הוא null.
ה destinationFileName
, שם הקובץ, או שניהם חורגים מהאורך המרבי המוגדר על ידי המערכת. לדוגמה, בפלטפורמות מבוססות Windows, הנתיבים חייבים להיות פחות מ-248 תווים, ושמות הקבצים חייבים להיות פחות מ-260 תווים.
ה destinationFileName
המצויין אינו חוקי, (למשל, הוא נמצא בכונן שאינו ממופה).
שגיאת I/O התרחשה בעת פתיחת הקובץ.
destinationFileName
מציין קובץ שהוא רק לקריאה וגישה אינה אפשרית. - או - הנתיב מציין תיקיה. - או - ה caller אינו בעל ההרשאה הנדרשת.
destinationFileName
נמצא בפורמט לא חוקי.
הקובץ לא נמצא.
SaveGzipped(Stream, TarFormat?)
שומר את הארכיון לזרם עם דחיסת gzip.
public void SaveGzipped(Stream output, TarFormat? format = null)
פרמטרים
output
Stream
זרם היעד.
format
TarFormat?
מגדיר את פורמט הכותרת של tar. ערך null יתפרש כ-USTar כאשר אפשרי.
דוגמאות
using (FileStream result = File.OpenWrite("result.tar.gz"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveGzipped(result);
}
}
}
הערות
output
חייב להיות ניתן לכתיבה.
חריגות
output
הוא null.
output
אינו ניתן לכתיבה.
SaveGzipped(string, TarFormat?)
שומר את הארכיון לקובץ לפי הנתיב עם דחיסת gzip.
public void SaveGzipped(string path, TarFormat? format = null)
פרמטרים
path
string
הנתיב של הארכיון שיתוצר. אם שם הקובץ המצויין מפנה לקובץ קיים, הוא יימחק.
format
TarFormat?
מגדיר את פורמט הכותרת של tar. ערך null יתפרש כ-USTar כאשר אפשרי.
דוגמאות
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveGzipped("result.tar.gz");
}
}
SaveLZMACompressed(Stream, TarFormat?)
שומר את הארכיון לזרם עם דחיסת LZMA.
public void SaveLZMACompressed(Stream output, TarFormat? format = null)
פרמטרים
output
Stream
זרם היעד.
format
TarFormat?
מגדיר את פורמט הכותרת של tar. ערך null יתפרש כ-USTar כאשר אפשרי.
דוגמאות
using (FileStream result = File.OpenWrite("result.tar.lzma"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveLZMACompressed(result);
}
}
}
הערות
output
חייב להיות ניתן לכתיבה.
חריגות
output
הוא null.
output
אינו ניתן לכתיבה.
SaveLZMACompressed(string, TarFormat?)
שומר את הארכיון לקובץ לפי הנתיב עם דחיסת lzma.
public void SaveLZMACompressed(string path, TarFormat? format = null)
פרמטרים
path
string
הנתיב של הארכיון שיתוצר. אם שם הקובץ המצויין מפנה לקובץ קיים, הוא יימחק.
format
TarFormat?
מגדיר את פורמט הכותרת של tar. ערך null יתפרש כ-USTar כאשר אפשרי.
דוגמאות
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveLZMACompressed("result.tar.lzma");
}
}
הערות
חשוב: הארכיון tar מורכב ולאחר מכן נדחס בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.
SaveLzipped(Stream, TarFormat?)
שומר את הארכיון לזרם עם דחיסת lzip.
public void SaveLzipped(Stream output, TarFormat? format = null)
פרמטרים
output
Stream
זרם היעד.
format
TarFormat?
מגדיר את פורמט הכותרת של tar. ערך null יתפרש כ-USTar כאשר אפשרי.
דוגמאות
using (FileStream result = File.OpenWrite("result.tar.lz"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveLzipped(result);
}
}
}
הערות
output
חייב להיות ניתן לכתיבה.
חריגות
output
הוא null.
output
אינו ניתן לכתיבה.
SaveLzipped(string, TarFormat?)
שומר את הארכיון לקובץ לפי הנתיב עם דחיסת lzip.
public void SaveLzipped(string path, TarFormat? format = null)
פרמטרים
path
string
הנתיב של הארכיון שיתוצר. אם שם הקובץ המצויין מפנה לקובץ קיים, הוא יימחק.
format
TarFormat?
מגדיר את פורמט הכותרת של tar. ערך null יתפרש כ-USTar כאשר אפשרי.
דוגמאות
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveGzipped("result.tar.lz");
}
}
SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)
שומר את הארכיון לזרם עם דחיסת xz.
public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)
פרמטרים
output
Stream
זרם היעד.
format
TarFormat?
מגדיר את פורמט הכותרת של tar. ערך null יתפרש כ-USTar כאשר אפשרי.
settings
XzArchiveSettings
סט של הגדרות עבור הארכיון xz: גודל מילון, גודל בלוק, סוג בדיקה.
דוגמאות
using (FileStream result = File.OpenWrite("result.tar.xz"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveXzCompressed(result);
}
}
}
הערות
output
חייב להיות ניתן לכתיבה.
חריגות
output
הוא null.
output
אינו ניתן לכתיבה.
SaveXzCompressed(string, TarFormat?, XzArchiveSettings)
שומר את הארכיון לפי הנתיב עם דחיסת xz.
public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)
פרמטרים
path
string
הנתיב של הארכיון שיתוצר. אם שם הקובץ המצויין מפנה לקובץ קיים, הוא יימחק.
format
TarFormat?
מגדיר את פורמט הכותרת של tar. ערך null יתפרש כ-USTar כאשר אפשרי.
settings
XzArchiveSettings
סט של הגדרות עבור הארכיון xz: גודל מילון, גודל בלוק, סוג בדיקה.
דוגמאות
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveXzCompressed("result.tar.xz");
}
}
SaveZCompressed(Stream, TarFormat?)
שומר את הארכיון לזרם עם דחיסת Z.
public void SaveZCompressed(Stream output, TarFormat? format = null)
פרמטרים
output
Stream
זרם היעד.
format
TarFormat?
מגדיר את פורמט הכותרת של tar. ערך null יתפרש כ-USTar כאשר אפשרי.
דוגמאות
using (FileStream result = File.OpenWrite("result.tar.Z"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveZCompressed(result);
}
}
}
הערות
output
חייב להיות ניתן לכתיבה.
חריגות
output
הוא null.
output
אינו ניתן לכתיבה.
SaveZCompressed(string, TarFormat?)
שומר את הארכיון לפי הנתיב עם דחיסת Z.
public void SaveZCompressed(string path, TarFormat? format = null)
פרמטרים
path
string
הנתיב של הארכיון שיתוצר. אם שם הקובץ המצויין מפנה לקובץ קיים, הוא יימחק.
format
TarFormat?
מגדיר את פורמט הכותרת של tar. ערך null יתפרש כ-USTar כאשר אפשרי.
דוגמאות
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveZCompressed("result.tar.Z");
}
}
SaveZstandard(Stream, TarFormat?)
שומר את הארכיון לזרם עם דחיסת Zstandard.
public void SaveZstandard(Stream output, TarFormat? format = null)
פרמטרים
output
Stream
זרם היעד.
format
TarFormat?
מגדיר את פורמט הכותרת של tar. ערך null יתפרש כ-USTar כאשר אפשרי.
דוגמאות
using (FileStream result = File.OpenWrite("result.tar.zst"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveZstandard(result);
}
}
}
הערות
output
חייב להיות ניתן לכתיבה.
חריגות
output
הוא null.
output
אינו ניתן לכתיבה.
SaveZstandard(string, TarFormat?)
שומר את הארכיון לקובץ לפי הנתיב עם דחיסת Zstandard.
public void SaveZstandard(string path, TarFormat? format = null)
פרמטרים
path
string
הנתיב של הארכיון שיתוצר. אם שם הקובץ המצויין מפנה לקובץ קיים, הוא יימחק.
format
TarFormat?
מגדיר את פורמט הכותרת של tar. ערך null יתפרש כ-USTar כאשר אפשרי.
דוגמאות
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveZstandard("result.tar.zst");
}
}