Class TarArchive

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 אינו בעל ההרשאה הנדרשת לגישה.

UnauthorizedAccessException

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

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

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

DirectoryNotFoundException

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

FileNotFoundException

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

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

ReadOnlyCollection<TarEntry>

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

מאפיינים

Entries

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

public ReadOnlyCollection<tarentry> Entries { get; }

ערך המאפיין

שיטות

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

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

מחזיר

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 אם הפריט הוא תיקיה.

חריגות

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

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

מחזיר

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

חריגות

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

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

מחזיר

TarEntry

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

דוגמאות

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

הערות

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

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

חריגות

path הוא null.

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

UnauthorizedAccessException

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

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

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

DeleteEntry(TarEntry)

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

public TarArchive DeleteEntry(TarEntry entry)

פרמטרים

entry TarEntry

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

מחזיר

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

דוגמאות

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

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

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

מחזיר

ArgumentOutOfRangeException

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

דוגמאות

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

הערות

חריגות

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

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

הערות

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

הערות

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.

DirectoryNotFoundException

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

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

UnauthorizedAccessException

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

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

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

חריגות

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

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

חריגות

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.