Class TarArchive

Class TarArchive

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

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

public class TarArchive : IArchive, IDisposable

ירושה

objectTarArchive

מיישם

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 לפירוק.

חריגות

InvalidDataException

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 לפירוק.

חריגות

ArgumentNullException

path הוא null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

מאפיינים

Entries

מקבל את הפריטים מסוג Aspose.Zip.Tar.TarEntry המהווים את הארכיון.

public ReadOnlyCollection<tarentry> Entries { get; }

ערך המאפיין

ReadOnlyCollection<TarEntry&gt;

שיטות

CreateEntries(DirectoryInfo, bool)

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

public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

פרמטרים

directory DirectoryInfo

תיקיה לדחיסה.

includeRootDirectory bool

מציין אם לכלול את התיקיה הראשית עצמה או לא.

מחזיר

TarArchive

הארכיון עם הפריטים המרכיבים.

דוגמאות

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

מציין אם לכלול את התיקיה הראשית עצמה או לא.

מחזיר

TarArchive

הארכיון עם הפריטים המרכיבים.

דוגמאות

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntries("C:\folder", false);
        archive.Save(tarFile);
    }
}

חריגות

ArgumentNullException

sourceDirectory הוא null.

SecurityException

ה caller אינו בעל ההרשאה הנדרשת לגישה ל sourceDirectory.

ArgumentException

sourceDirectory מכיל תווים לא חוקיים כמו “, <, >, או |.

PathTooLongException

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

CreateEntry(string, Stream, FileSystemInfo)

יוצר פריט בודד בתוך הארכיון.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)

פרמטרים

name string

שם הפריט.

source Stream

הזרם הקלט עבור הפריט.

fileInfo FileSystemInfo

מטא-מידע של קובץ או תיקיה שיש לדחוס.

מחזיר

TarEntry

מופע של פריט tar.

דוגמאות

using (var archive = new TarArchive())
{
   archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
   archive.Save(tarFile);
}

הערות

שם הפריט נקבע אך ורק בפרמטר name. שם הקובץ שניתן בפרמטר fileInfo אינו משפיע על שם הפריט.

fileInfo יכול להתייחס ל- System.IO.DirectoryInfo אם הפריט הוא תיקיה.

חריגות

PathTooLongException

name ארוך מדי עבור tar לפי תקן IEEE 1003.1-1998.

ArgumentException

שם הקובץ, כחלק מ-name, חורג מ-100 תווים.

CreateEntry(string, FileInfo, bool)

יוצר פריט בודד בתוך הארכיון.

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

פרמטרים

name string

שם הפריט.

fileInfo FileInfo

מטא-מידע של קובץ או תיקיה שיש לדחוס.

openImmediately bool

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

מחזיר

TarEntry

מופע של פריט 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, הוא חסום עד שהארכיון יושלך.

חריגות

PathTooLongException

name ארוך מדי עבור tar לפי תקן IEEE 1003.1-1998.

ArgumentException

שם הקובץ, כחלק מ-name, חורג מ-100 תווים.

CreateEntry(string, string, bool)

יוצר פריט בודד בתוך הארכיון.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)

פרמטרים

name string

שם הפריט.

path string

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

openImmediately bool

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

מחזיר

TarEntry

מופע של פריט tar.

דוגמאות

using (var archive = new TarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save(outputTarFile);
}

הערות

שם הפריט נקבע אך ורק בפרמטר name. שם הקובץ שניתן בפרמטר path אינו משפיע על שם הפריט.

אם הקובץ נפתח מיד עם פרמטר openImmediately, הוא חסום עד שהארכיון יושלך.

חריגות

ArgumentNullException

path הוא null.

SecurityException

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

ArgumentException

ה path ריק, מכיל רק רווחים, או מכיל תווים לא חוקיים. - או - שם הקובץ, כחלק מ-name, חורג מ-100 תווים.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

DeleteEntry(TarEntry)

מסיר את ההתרחשות הראשונה של פריט ספציפי מרשימת הפריטים.

public TarArchive DeleteEntry(TarEntry entry)

פרמטרים

entry TarEntry

הפריט להסרה מרשימת הפריטים.

מחזיר

TarArchive

הארכיון עם הפריט שנמחק.

דוגמאות

הנה איך אתה יכול להסיר את כל הפריטים מלבד האחרון:

using (var archive = new TarArchive("archive.tar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputTarFile);
}

DeleteEntry(int)

מסיר את הפריט מרשימת הפריטים לפי אינדקס.

public TarArchive DeleteEntry(int entryIndex)

פרמטרים

entryIndex int

האינדקס של הפריט להסרה.

מחזיר

TarArchive

הארכיון עם הפריט שנמחק.

דוגמאות

using (var archive = new TarArchive("two_files.tar"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.tar");
}

חריגות

ArgumentOutOfRangeException

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");
}

הערות

אם התיקיה אינה קיימת, היא תיווצר.

חריגות

ArgumentNullException

path הוא null

PathTooLongException

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

SecurityException

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

NotSupportedException

אם התיקיה אינה קיימת, הנתיב מכיל תו נקודתיים (:) שאינו חלק מתווית כונן (“C:").

ArgumentException

הנתיב הוא מחרוזת באורך אפס, מכיל רק רווחים, או מכיל תו לא חוקי אחד או יותר. אתה יכול לשאול על תווים לא חוקיים באמצעות מתודת System.IO.Path.GetInvalidPathChars. -או- הנתיב מקדים, או מכיל, רק תו נקודתיים (:).

IOException

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

FromGZip(Stream)

חולץ את הארכיון gzip המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.

חשוב: הארכיון gzip מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.

public static TarArchive FromGZip(Stream source)

פרמטרים

source Stream

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

מחזיר

TarArchive

מופע של Aspose.Zip.Tar.TarArchive

הערות

זרם החילוץ של GZip אינו ניתן לחיפוש מטבעו של אלגוריתם הדחיסה. הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.

חריגות

InvalidDataException

הארכיון פגום.

FromGZip(string)

חולץ את הארכיון gzip המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.

חשוב: הארכיון gzip מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.

public static TarArchive FromGZip(string path)

פרמטרים

path string

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

מחזיר

TarArchive

מופע של Aspose.Zip.Tar.TarArchive

הערות

זרם החילוץ של GZip אינו ניתן לחיפוש מטבעו של אלגוריתם הדחיסה. הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.

חריגות

InvalidDataException

הארכיון פגום.

FromLZMA(Stream)

חולץ את הארכיון LZMA המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.

חשוב: הארכיון LZMA מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.

public static TarArchive FromLZMA(Stream source)

פרמטרים

source Stream

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

מחזיר

TarArchive

מופע של Aspose.Zip.Tar.TarArchive

הערות

זרם החילוץ של LZMA אינו ניתן לחיפוש מטבעו של אלגוריתם הדחיסה. הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.

FromLZMA(string)

חולץ את הארכיון LZMA המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.

חשוב: הארכיון LZMA מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.

public static TarArchive FromLZMA(string path)

פרמטרים

path string

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

מחזיר

TarArchive

מופע של Aspose.Zip.Tar.TarArchive

הערות

זרם החילוץ של LZMA אינו ניתן לחיפוש מטבעו של אלגוריתם הדחיסה. הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.

FromLZip(Stream)

חולץ את הארכיון lzip המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.

חשוב: הארכיון lzip מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.

public static TarArchive FromLZip(Stream source)

פרמטרים

source Stream

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

מחזיר

TarArchive

מופע של Aspose.Zip.Tar.TarArchive

הערות

זרם החילוץ של lzip אינו ניתן לחיפוש מטבעו של אלגוריתם הדחיסה. הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.

FromLZip(string)

חולץ את הארכיון lzip המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.

חשוב: הארכיון lzip מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.

public static TarArchive FromLZip(string path)

פרמטרים

path string

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

מחזיר

TarArchive

מופע של Aspose.Zip.Tar.TarArchive

הערות

זרם החילוץ של lzip אינו ניתן לחיפוש מטבעו של אלגוריתם הדחיסה. הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.

FromXz(Stream)

חולץ את הארכיון בפורמט xz המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.

חשוב: הארכיון xz מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.

public static TarArchive FromXz(Stream source)

פרמטרים

source Stream

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

מחזיר

TarArchive

מופע של Aspose.Zip.Tar.TarArchive

הערות

הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.

FromXz(string)

חולץ את הארכיון בפורמט xz המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.

חשוב: הארכיון xz מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.

public static TarArchive FromXz(string path)

פרמטרים

path string

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

מחזיר

TarArchive

מופע של Aspose.Zip.Tar.TarArchive

הערות

הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.

FromZ(Stream)

חולץ את הארכיון בפורמט Z המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.

חשוב: הארכיון Z מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.

public static TarArchive FromZ(Stream source)

פרמטרים

source Stream

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

מחזיר

TarArchive

מופע של Aspose.Zip.Tar.TarArchive

הערות

הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.

FromZ(string)

חולץ את הארכיון בפורמט Z המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.

חשוב: הארכיון Z מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.

public static TarArchive FromZ(string path)

פרמטרים

path string

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

מחזיר

TarArchive

מופע של Aspose.Zip.Tar.TarArchive

הערות

הארכיון Tar מספק מתקנים לחלץ רשומות שרירותיות, כך שהוא חייב לפעול על זרם הניתן לחיפוש מתחת לפני השטח.

FromZstandard(Stream)

חולץ את הארכיון בפורמט Zstandard המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.

חשוב: הארכיון Zstandard מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.

public static TarArchive FromZstandard(Stream source)

פרמטרים

source Stream

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

מחזיר

TarArchive

מופע של Aspose.Zip.Tar.TarArchive

חריגות

IOException

זרם Zstandard פגום או לא ניתן לקריאה.

InvalidDataException

הנתונים פגומים.

FromZstandard(string)

חולץ את הארכיון בפורמט Zstandard המסופק ומרכיב Aspose.Zip.Tar.TarArchive מנתוני החילוץ.

חשוב: הארכיון Zstandard מחולץ לחלוטין בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.

public static TarArchive FromZstandard(string path)

פרמטרים

path string

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

מחזיר

TarArchive

מופע של Aspose.Zip.Tar.TarArchive

חריגות

IOException

זרם Zstandard פגום או לא ניתן לקריאה.

InvalidDataException

הנתונים פגומים.

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 חייב להיות ניתן לכתיבה.

חריגות

ArgumentException

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");
}

הערות

אפשר לשמור ארכיון באותו נתיב שבו הוא נטען ממנו. עם זאת, זה לא מומלץ מכיוון שגישה זו משתמשת בהעתקה לקובץ זמני.

חריגות

ArgumentException

destinationFileName הוא מחרוזת באורך אפס, מכיל רק רווחים, או מכיל תו לא חוקי אחד או יותר כפי שמוגדר על ידי System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName הוא null.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

שגיאת I/O התרחשה בעת פתיחת הקובץ.

UnauthorizedAccessException

destinationFileName מציין קובץ שהוא רק לקריאה וגישה אינה אפשרית. - או - הנתיב מציין תיקיה. - או - ה caller אינו בעל ההרשאה הנדרשת.

NotSupportedException

destinationFileName נמצא בפורמט לא חוקי.

FileNotFoundException

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

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 חייב להיות ניתן לכתיבה.

חריגות

ArgumentNullException

output הוא null.

ArgumentException

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 חייב להיות ניתן לכתיבה.

חשוב: הארכיון tar מורכב ולאחר מכן נדחס בתוך שיטה זו, תוכנו נשמר פנימית. יש להיזהר מצריכת זיכרון.

חריגות

ArgumentNullException

output הוא null.

ArgumentException

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 חייב להיות ניתן לכתיבה.

חריגות

ArgumentNullException

output הוא null.

ArgumentException

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 חייב להיות ניתן לכתיבה.

חריגות

ArgumentNullException

output הוא null.

ArgumentException

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 חייב להיות ניתן לכתיבה.

חריגות

ArgumentNullException

output הוא null.

ArgumentException

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 חייב להיות ניתן לכתיבה.

חריגות

ArgumentNullException

output הוא null.

ArgumentException

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");
    }
}
 Ελληνικά