TarFile.ExtractToDirectory Metoda

Definice

Obor názvů:

System.Formats.Tar

Sestavení:

System.Formats.Tar.dll

Přetížení

Name	Description
ExtractToDirectory(Stream, String, Boolean)	Extrahuje obsah datového proudu, který představuje archiv tar do zadaného adresáře.
ExtractToDirectory(String, String, Boolean)	Extrahuje obsah souboru tar do zadaného adresáře.

ExtractToDirectory(Stream, String, Boolean)

Zdroj:

TarFile.cs

Extrahuje obsah datového proudu, který představuje archiv tar do zadaného adresáře.

public:
 static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, bool overwriteFiles);

public static void ExtractToDirectory(System.IO.Stream source, string destinationDirectoryName, bool overwriteFiles);

static member ExtractToDirectory : System.IO.Stream * string * bool -> unit

Public Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean)

Parametry

source

Stream

Stream obsahující archiv tar.

destinationDirectoryName

String

Cesta cílového adresáře, do kterého se mají extrahovat položky systému souborů.

overwriteFiles

Boolean

truepřepsání souborů a adresářůdestinationDirectoryNamefalse, aby se zabránilo přepsání a vyvolání, pokud jsou nalezeny nějaké soubory nebo adresáře s existujícími názvy.

Výjimky

ArgumentNullException

source nebo destinationDirectoryName je null.

DirectoryNotFoundException

Cesta destinationDirectoryName k adresáři nebyla nalezena.

UnauthorizedAccessException

Oprávnění nejsou dostatečná.

ArgumentException

Extrahování jedné z položek tar by vedlo k vytvoření souboru mimo zadaný cílový adresář.

nebo

destinationDirectoryName je prázdný.

nebo

source nepodporuje čtení.

InvalidDataException

.NET pouze verze 11 a novější: Kontrolní součet položky je neplatný.

IOException

Došlo k výjimce vstupně-výstupních operací.

Poznámky

Pokud symbolické propojení nebo spojení v archivu tar vede k extrahování souboru mimo zadané destinationDirectoryName, IOException je vyvolána, aby extrakce zůstala ve stejném adresáři.

Pokud destinationDirectoryName nebo některý z jeho nadřazených adresářů je již existující spojení nebo symbolický odkaz, zapíše se odkaz a extrahování se zapíše do konečné cílové složky.

Soubory typu BlockDevice, CharacterDevicenebo Fifo lze extrahovat pouze v unixových platformách.

K extrahování BlockDevice nebo CharacterDevice na disk se vyžaduje zvýšení oprávnění.

Tato metoda neomezuje celkovou extrahovanou velikost ani počet položek extrahovaných z archivu. Při zpracování archivů z nedůvěryhodných zdrojů iterujte položky ručně pomocí TarReadera ověřte, že velikost a počet položek jsou pro váš scénář v přijatelných mezích.

ExtractToDirectory(String, String, Boolean)

Zdroj:

TarFile.cs

Extrahuje obsah souboru tar do zadaného adresáře.

public:
 static void ExtractToDirectory(System::String ^ sourceFileName, System::String ^ destinationDirectoryName, bool overwriteFiles);

public static void ExtractToDirectory(string sourceFileName, string destinationDirectoryName, bool overwriteFiles);

static member ExtractToDirectory : string * string * bool -> unit

Public Shared Sub ExtractToDirectory (sourceFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean)

Parametry

sourceFileName

String

Cesta k souboru tar, který se má extrahovat.

destinationDirectoryName

String

Cesta cílového adresáře, do kterého se mají extrahovat položky systému souborů.

overwriteFiles

Boolean

truepřepsání souborů a adresářůdestinationDirectoryNamefalse, aby se zabránilo přepsání a vyvolání, pokud jsou nalezeny nějaké soubory nebo adresáře s existujícími názvy.

Výjimky

ArgumentNullException

sourceFileName nebo destinationDirectoryName je null.

DirectoryNotFoundException

Cesta destinationDirectoryName k adresáři nebyla nalezena.

FileNotFoundException

Cesta sourceFileName k souboru nebyla nalezena.

UnauthorizedAccessException

Oprávnění nejsou dostatečná.

ArgumentException

Extrahování jedné z položek tar by vedlo k vytvoření souboru mimo zadaný cílový adresář.

nebo

sourceFileName nebo destinationDirectoryName je prázdný.

InvalidDataException

.NET pouze verze 11 a novější: Kontrolní součet položky je neplatný.

IOException

Došlo k výjimce vstupně-výstupních operací.

Poznámky

Pokud symbolické propojení nebo spojení v archivu tar vede k extrahování souboru mimo zadané destinationDirectoryName, IOException je vyvolána, aby extrakce zůstala ve stejném adresáři.

Pokud destinationDirectoryName nebo některý z jeho nadřazených adresářů je již existující spojení nebo symbolický odkaz, zapíše se odkaz a extrahování se zapíše do konečné cílové složky.

Soubory typu BlockDevice, CharacterDevicenebo Fifo lze extrahovat pouze v unixových platformách.

K extrahování BlockDevice nebo CharacterDevice na disk se vyžaduje zvýšení oprávnění.

Tato metoda neomezuje celkovou extrahovanou velikost ani počet položek extrahovaných z archivu. Při zpracování archivů z nedůvěryhodných zdrojů iterujte položky ručně pomocí TarReadera ověřte, že velikost a počet položek jsou pro váš scénář v přijatelných mezích.