Taal

TarFile.ExtractToDirectory Methode

Definitie

Naamruimte:
System.Formats.Tar
Assembly:
System.Formats.Tar.dll

Overloads

Name Description
ExtractToDirectory(Stream, String, Boolean)

Extraheert de inhoud van een stroom die een tar-archief vertegenwoordigt in de opgegeven map.
ExtractToDirectory(Stream, String, TarExtractOptions)
ExtractToDirectory(String, String, Boolean)

Extraheert de inhoud van een tar-bestand in de opgegeven map.
ExtractToDirectory(String, String, TarExtractOptions)

ExtractToDirectory(Stream, String, Boolean)

Bron:
TarFile.cs
Bron:
TarFile.cs
Bron:
TarFile.cs
Bron:
TarFile.cs
Bron:
TarFile.cs

Extraheert de inhoud van een stroom die een tar-archief vertegenwoordigt in de opgegeven map.

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)

Parameters

source
Stream

De stroom met het tar-archief.

destinationDirectoryName
String

Het pad van de doelmap waarin de bestandssysteemvermeldingen moeten worden geëxtraheerd.

overwriteFiles
Boolean

true om bestanden en mappen in destinationDirectoryNamete overschrijven; false om te voorkomen dat bestanden of mappen worden overschreven en als er bestanden of mappen worden gevonden met bestaande namen.

Uitzonderingen

ArgumentNullException

source of destinationDirectoryName is null.

DirectoryNotFoundException

Het pad naar de destinationDirectoryName map is niet gevonden.

UnauthorizedAccessException

Machtigingen zijn onvoldoende.

ArgumentException

Het extraheren van een van de tar-vermeldingen zou hebben geresulteerd in een bestand buiten de opgegeven doelmap.

– of –

destinationDirectoryName is leeg.

– of –

source biedt geen ondersteuning voor lezen.

InvalidDataException

alleen .NET 11 en nieuwere versies: de controlesom van een vermelding is ongeldig.

IOException

Er is een I/O-uitzondering opgetreden.

Opmerkingen

Als een symbolische koppeling of verbinding in het tar-archief resulteert in een bestand dat buiten de opgegeven destinationDirectoryNamemap wordt geëxtraheerd, wordt er een IOException gegenereerd om ervoor te zorgen dat extractie binnen dezelfde map blijft.

Als destinationDirectoryName of een van de bovenliggende mappen een bestaande verbinding of symbolische koppeling is, wordt de koppeling gevolgd en wordt de extractie naar de uiteindelijke doelmap geschreven.

Bestanden van het type BlockDevice, CharacterDeviceof Fifo kunnen alleen worden geëxtraheerd op Unix-platforms.

Benodigde bevoegdheden zijn vereist voor het extraheren van een BlockDevice of CharacterDevice naar schijf.

Deze methode beperkt niet de totale uitgepakte grootte of het aantal vermeldingen dat uit het archief is geëxtraheerd. Wanneer u archieven van niet-vertrouwde bronnen verwerkt, moet u de items handmatig herhalen met behulp van TarReaderen controleren of de grootte en het aantal vermeldingen binnen acceptabele limieten voor uw scenario vallen.

Van toepassing op

ExtractToDirectory(Stream, String, TarExtractOptions)

Bron:
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)

Parameters

source
Stream
destinationDirectoryName
String
options
TarExtractOptions

Van toepassing op

ExtractToDirectory(String, String, Boolean)

Bron:
TarFile.cs
Bron:
TarFile.cs
Bron:
TarFile.cs
Bron:
TarFile.cs
Bron:
TarFile.cs

Extraheert de inhoud van een tar-bestand in de opgegeven map.

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)

Parameters

sourceFileName
String

Het pad van het tar-bestand dat moet worden geëxtraheerd.

destinationDirectoryName
String

Het pad van de doelmap waarin de bestandssysteemvermeldingen moeten worden geëxtraheerd.

overwriteFiles
Boolean

true om bestanden en mappen in destinationDirectoryNamete overschrijven; false om te voorkomen dat bestanden of mappen worden overschreven en als er bestanden of mappen worden gevonden met bestaande namen.

Uitzonderingen

ArgumentNullException

sourceFileName of destinationDirectoryName is null.

DirectoryNotFoundException

Het pad naar de destinationDirectoryName map is niet gevonden.

FileNotFoundException

Het sourceFileName bestandspad is niet gevonden.

UnauthorizedAccessException

Machtigingen zijn onvoldoende.

ArgumentException

Het extraheren van een van de tar-vermeldingen zou hebben geresulteerd in een bestand buiten de opgegeven doelmap.

– of –

sourceFileName of destinationDirectoryName is leeg.

InvalidDataException

alleen .NET 11 en nieuwere versies: de controlesom van een vermelding is ongeldig.

IOException

Er is een I/O-uitzondering opgetreden.

Opmerkingen

Als een symbolische koppeling of verbinding in het tar-archief resulteert in een bestand dat buiten de opgegeven destinationDirectoryNamemap wordt geëxtraheerd, wordt er een IOException gegenereerd om ervoor te zorgen dat extractie binnen dezelfde map blijft.

Als destinationDirectoryName of een van de bovenliggende mappen een bestaande verbinding of symbolische koppeling is, wordt de koppeling gevolgd en wordt de extractie naar de uiteindelijke doelmap geschreven.

Bestanden van het type BlockDevice, CharacterDeviceof Fifo kunnen alleen worden geëxtraheerd op Unix-platforms.

Benodigde bevoegdheden zijn vereist voor het extraheren van een BlockDevice of CharacterDevice naar schijf.

Deze methode beperkt niet de totale uitgepakte grootte of het aantal vermeldingen dat uit het archief is geëxtraheerd. Wanneer u archieven van niet-vertrouwde bronnen verwerkt, moet u de items handmatig herhalen met behulp van TarReaderen controleren of de grootte en het aantal vermeldingen binnen acceptabele limieten voor uw scenario vallen.

Van toepassing op

ExtractToDirectory(String, String, TarExtractOptions)

Bron:
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)

Parameters

sourceFileName
String
destinationDirectoryName
String
options
TarExtractOptions

Van toepassing op