Språk

TarFile.ExtractToDirectory Metod

Definition

Namnområde:
System.Formats.Tar
Sammansättning:
System.Formats.Tar.dll

Överlagringar

Name Description
ExtractToDirectory(Stream, String, Boolean)

Extraherar innehållet i en ström som representerar ett tjärarkiv till den angivna katalogen.
ExtractToDirectory(Stream, String, TarExtractOptions)
ExtractToDirectory(String, String, Boolean)

Extraherar innehållet i en tar-fil till den angivna katalogen.
ExtractToDirectory(String, String, TarExtractOptions)

ExtractToDirectory(Stream, String, Boolean)

Källa:
TarFile.cs
Källa:
TarFile.cs
Källa:
TarFile.cs
Källa:
TarFile.cs
Källa:
TarFile.cs

Extraherar innehållet i en ström som representerar ett tjärarkiv till den angivna katalogen.

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)

Parametrar

source
Stream

Strömmen som innehåller tjärarkivet.

destinationDirectoryName
String

Sökvägen till målkatalogen där filsystemposterna ska extraheras.

overwriteFiles
Boolean

true för att skriva över filer och kataloger i destinationDirectoryName; false för att undvika överskrivning och kasta om några filer eller kataloger hittas med befintliga namn.

Undantag

ArgumentNullException

source eller destinationDirectoryName är null.

DirectoryNotFoundException

Katalogsökvägen destinationDirectoryName hittades inte.

UnauthorizedAccessException

Behörigheterna är otillräckliga.

ArgumentException

Om du extraherade en av tjärposterna skulle det ha resulterat i en fil utanför den angivna målkatalogen.

-eller-

destinationDirectoryName är tom.

-eller-

source stöder inte läsning.

InvalidDataException

.NET endast 11 och senare versioner: En posts kontrollsumma är ogiltig.

IOException

Ett I/O-undantag inträffade.

Kommentarer

Om en symbolisk länk eller korsning i tjärarkivet resulterar i att en fil extraheras utanför angiven destinationDirectoryNamegenereras en IOException för att säkerställa att extrahering förblir inom samma katalog.

Om destinationDirectoryName eller någon av dess överordnade kataloger är en befintlig koppling eller symbolisk länk följs länken och extraheringsskrivningarna till den slutliga målmappen.

Filer av typen BlockDevice, CharacterDeviceeller Fifo kan bara extraheras i Unix-plattformar.

Utökade privilegier krävs för att extrahera en BlockDevice eller CharacterDevice till disk.

Den här metoden begränsar inte den totala extraherade storleken eller antalet poster som extraheras från arkivet. När du bearbetar arkiv från ej betrodda källor itererar du över posterna manuellt med hjälp av TarReaderoch kontrollerar att storleken och antalet poster ligger inom godkända gränser för ditt scenario.

Gäller för

ExtractToDirectory(Stream, String, TarExtractOptions)

Källa:
TarFile.cs
public:
 static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, System::Formats::Tar::TarExtractOptions ^ options);
public static void ExtractToDirectory(System.IO.Stream source, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options);
static member ExtractToDirectory : System.IO.Stream * string * System.Formats.Tar.TarExtractOptions -> unit
Public Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, options As TarExtractOptions)

Parametrar

source
Stream
destinationDirectoryName
String
options
TarExtractOptions

Gäller för

ExtractToDirectory(String, String, Boolean)

Källa:
TarFile.cs
Källa:
TarFile.cs
Källa:
TarFile.cs
Källa:
TarFile.cs
Källa:
TarFile.cs

Extraherar innehållet i en tar-fil till den angivna katalogen.

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)

Parametrar

sourceFileName
String

Sökvägen till tar-filen som ska extraheras.

destinationDirectoryName
String

Sökvägen till målkatalogen där filsystemposterna ska extraheras.

overwriteFiles
Boolean

true för att skriva över filer och kataloger i destinationDirectoryName; false för att undvika överskrivning och kasta om några filer eller kataloger hittas med befintliga namn.

Undantag

ArgumentNullException

sourceFileName eller destinationDirectoryName är null.

DirectoryNotFoundException

Katalogsökvägen destinationDirectoryName hittades inte.

FileNotFoundException

Det sourceFileName går inte att hitta filsökvägen.

UnauthorizedAccessException

Behörigheterna är otillräckliga.

ArgumentException

Om du extraherade en av tjärposterna skulle det ha resulterat i en fil utanför den angivna målkatalogen.

-eller-

sourceFileName eller destinationDirectoryName är tom.

InvalidDataException

.NET endast 11 och senare versioner: En posts kontrollsumma är ogiltig.

IOException

Ett I/O-undantag inträffade.

Kommentarer

Om en symbolisk länk eller korsning i tjärarkivet resulterar i att en fil extraheras utanför angiven destinationDirectoryNamegenereras en IOException för att säkerställa att extrahering förblir inom samma katalog.

Om destinationDirectoryName eller någon av dess överordnade kataloger är en befintlig koppling eller symbolisk länk följs länken och extraheringsskrivningarna till den slutliga målmappen.

Filer av typen BlockDevice, CharacterDeviceeller Fifo kan bara extraheras i Unix-plattformar.

Utökade privilegier krävs för att extrahera en BlockDevice eller CharacterDevice till disk.

Den här metoden begränsar inte den totala extraherade storleken eller antalet poster som extraheras från arkivet. När du bearbetar arkiv från ej betrodda källor itererar du över posterna manuellt med hjälp av TarReaderoch kontrollerar att storleken och antalet poster ligger inom godkända gränser för ditt scenario.

Gäller för

ExtractToDirectory(String, String, TarExtractOptions)

Källa:
TarFile.cs
public:
 static void ExtractToDirectory(System::String ^ sourceFileName, System::String ^ destinationDirectoryName, System::Formats::Tar::TarExtractOptions ^ options);
public static void ExtractToDirectory(string sourceFileName, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options);
static member ExtractToDirectory : string * string * System.Formats.Tar.TarExtractOptions -> unit
Public Shared Sub ExtractToDirectory (sourceFileName As String, destinationDirectoryName As String, options As TarExtractOptions)

Parametrar

sourceFileName
String
destinationDirectoryName
String
options
TarExtractOptions

Gäller för