TarFile.ExtractToDirectory Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Overloads
| Naam | 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 -> unitPublic 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. In .NET 11 en eerdere versies moet de map al bestaan. In .NET 12 en nieuwere versies worden ontbrekende doel- en bovenliggende mappen gemaakt wanneer vermeldingen worden geëxtraheerd. Een leeg archief maakt geen mappen.
- 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
source of destinationDirectoryName is null.
.NET 11 en eerdere versies: de destinationDirectoryName map bestaat niet.
Machtigingen zijn onvoldoende.
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.
alleen .NET 11 en nieuwere versies: de controlesom van een vermelding is ongeldig.
Er is een I/O-uitzondering opgetreden.
Opmerkingen
Warning
Deze methode mag niet worden gebruikt om niet-vertrouwde archieven te extraheren. Er worden geen groottelimieten, limieten voor het aantal vermeldingen of andere beleidsregels afgedwongen die nodig zijn voor veilige extractie van niet-vertrouwde archieven. Zie Best practices voor het gebruik van zip- en tar-archieven voor meer informatie over het veilig extraheren van archieven uit niet-vertrouwde bronnen.
In .NET 11 en eerdere versies moet de map die is opgegeven doordestinationDirectoryName, al bestaan. Als deze niet bestaat, genereert deze methode een DirectoryNotFoundException, zelfs als het archief leeg is.
In .NET 12 en latere versies kan de doelmap al bestaan. Ontbrekende doel- en bovenliggende mappen worden zo nodig gemaakt wanneer vermeldingen worden geëxtraheerd. Een leeg archief maakt geen mappen.
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.
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 -> unitPublic Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, options As TarExtractOptions)Parameters
- source
- Stream
- destinationDirectoryName
- String
Het pad naar de map waarin de geëxtraheerde bestanden moeten worden opgeslagen. In .NET 11 en eerdere versies moet de map al bestaan. In .NET 12 en nieuwere versies worden ontbrekende doel- en bovenliggende mappen gemaakt wanneer vermeldingen worden geëxtraheerd. Een leeg archief maakt geen mappen.
- options
- TarExtractOptions
Uitzonderingen
.NET 11 en eerdere versies: de destinationDirectoryName map bestaat niet.
Opmerkingen
Warning
Deze methode mag niet worden gebruikt om niet-vertrouwde archieven te extraheren. Er worden geen groottelimieten, limieten voor het aantal vermeldingen of andere beleidsregels afgedwongen die nodig zijn voor veilige extractie van niet-vertrouwde archieven. Zie Best practices voor het gebruik van zip- en tar-archieven voor meer informatie over het veilig extraheren van archieven uit niet-vertrouwde bronnen.
In .NET 11 en eerdere versies moet de map die is opgegeven doordestinationDirectoryName, al bestaan. Als deze niet bestaat, genereert deze methode een DirectoryNotFoundException, zelfs als het archief leeg is.
In .NET 12 en latere versies kan de doelmap al bestaan. Ontbrekende doel- en bovenliggende mappen worden zo nodig gemaakt wanneer vermeldingen worden geëxtraheerd. Een leeg archief maakt geen mappen.
Het pad kan relatief of absoluut zijn. Een relatief pad wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
Als er een fout optreedt tijdens het extraheren, blijft het archief gedeeltelijk geëxtraheerd.
Ingesteld OverwriteFiles op true het overschrijven van bestaande bestanden. De standaardwaarde is false. Gebruik HardLinkMode dit om te bepalen hoe vermeldingen in vaste koppelingen worden geëxtraheerd.
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.
De source stroom blijft open na extractie.
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 -> unitPublic 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. In .NET 11 en eerdere versies moet de map al bestaan. In .NET 12 en nieuwere versies worden ontbrekende doel- en bovenliggende mappen gemaakt wanneer vermeldingen worden geëxtraheerd. Een leeg archief maakt geen mappen.
- 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
sourceFileName of destinationDirectoryName is null.
.NET 11 en eerdere versies: de destinationDirectoryName map bestaat niet.
Het sourceFileName bestandspad is niet gevonden.
Machtigingen zijn onvoldoende.
Het extraheren van een van de tar-vermeldingen zou hebben geresulteerd in een bestand buiten de opgegeven doelmap.
– of –
sourceFileName of destinationDirectoryName is leeg.
alleen .NET 11 en nieuwere versies: de controlesom van een vermelding is ongeldig.
Er is een I/O-uitzondering opgetreden.
Opmerkingen
Warning
Deze methode mag niet worden gebruikt om niet-vertrouwde archieven te extraheren. Er worden geen groottelimieten, limieten voor het aantal vermeldingen of andere beleidsregels afgedwongen die nodig zijn voor veilige extractie van niet-vertrouwde archieven. Zie Best practices voor het gebruik van zip- en tar-archieven voor meer informatie over het veilig extraheren van archieven uit niet-vertrouwde bronnen.
In .NET 11 en eerdere versies moet de map die is opgegeven doordestinationDirectoryName, al bestaan. Als deze niet bestaat, genereert deze methode een DirectoryNotFoundException, zelfs als het archief leeg is.
In .NET 12 en latere versies kan de doelmap al bestaan. Ontbrekende doel- en bovenliggende mappen worden zo nodig gemaakt wanneer vermeldingen worden geëxtraheerd. Een leeg archief maakt geen mappen.
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.
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 -> unitPublic Shared Sub ExtractToDirectory (sourceFileName As String, destinationDirectoryName As String, options As TarExtractOptions)Parameters
- sourceFileName
- String
- destinationDirectoryName
- String
Het pad naar de map waarin de geëxtraheerde bestanden moeten worden opgeslagen. In .NET 11 en eerdere versies moet de map al bestaan. In .NET 12 en nieuwere versies worden ontbrekende doel- en bovenliggende mappen gemaakt wanneer vermeldingen worden geëxtraheerd. Een leeg archief maakt geen mappen.
- options
- TarExtractOptions
Uitzonderingen
.NET 11 en eerdere versies: de destinationDirectoryName map bestaat niet.
Opmerkingen
Warning
Deze methode mag niet worden gebruikt om niet-vertrouwde archieven te extraheren. Er worden geen groottelimieten, limieten voor het aantal vermeldingen of andere beleidsregels afgedwongen die nodig zijn voor veilige extractie van niet-vertrouwde archieven. Zie Best practices voor het gebruik van zip- en tar-archieven voor meer informatie over het veilig extraheren van archieven uit niet-vertrouwde bronnen.
In .NET 11 en eerdere versies moet de map die is opgegeven doordestinationDirectoryName, al bestaan. Als deze niet bestaat, genereert deze methode een DirectoryNotFoundException, zelfs als het archief leeg is.
In .NET 12 en latere versies kan de doelmap al bestaan. Ontbrekende doel- en bovenliggende mappen worden zo nodig gemaakt wanneer vermeldingen worden geëxtraheerd. Een leeg archief maakt geen mappen.
Het pad kan relatief of absoluut zijn. Een relatief pad wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap.
Als er een fout optreedt tijdens het extraheren, blijft het archief gedeeltelijk geëxtraheerd.
Ingesteld OverwriteFiles op true het overschrijven van bestaande bestanden. De standaardwaarde is false. Gebruik HardLinkMode dit om te bepalen hoe vermeldingen in vaste koppelingen worden geëxtraheerd.
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.
