TarFile.ExtractToDirectoryAsync 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 |
|---|---|
| ExtractToDirectoryAsync(String, String, Boolean, CancellationToken) |
De inhoud van een tar-bestand wordt asynchroon geëxtraheerd in de opgegeven map. |
| ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken) |
Asynchroon extraheert de inhoud van een stroom die een tar-archief vertegenwoordigt in de opgegeven map. |
| ExtractToDirectoryAsync(Stream, String, TarExtractOptions, CancellationToken) | |
| ExtractToDirectoryAsync(String, String, TarExtractOptions, CancellationToken) |
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)
- Bron:
- TarFile.cs
- Bron:
- TarFile.cs
- Bron:
- TarFile.cs
- Bron:
- TarFile.cs
- Bron:
- TarFile.cs
De inhoud van een tar-bestand wordt asynchroon geëxtraheerd in de opgegeven map.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceFileName, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : string * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (sourceFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- 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.
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen. De standaardwaarde is None.
Retouren
Een taak die de asynchrone extractiebewerking vertegenwoordigt.
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.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
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.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door ExtractToDirectory(String, String, Boolean)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)
- Bron:
- TarFile.cs
- Bron:
- TarFile.cs
- Bron:
- TarFile.cs
- Bron:
- TarFile.cs
- Bron:
- TarFile.cs
Asynchroon extraheert de inhoud van een stroom die een tar-archief vertegenwoordigt in de opgegeven map.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Stream * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- 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.
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen. De standaardwaarde is None.
Retouren
Een taak die de asynchrone extractiebewerking vertegenwoordigt.
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.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
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.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door ExtractToDirectory(Stream, String, Boolean)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
ExtractToDirectoryAsync(Stream, String, TarExtractOptions, CancellationToken)
- Bron:
- TarFile.cs
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Stream * string * System.Formats.Tar.TarExtractOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, options As TarExtractOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- 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
- cancellationToken
- CancellationToken
Retouren
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.
Uitzonderingen die optreden tijdens asynchrone extractie worden opgeslagen in de geretourneerde taak en worden gegenereerd wanneer de taak wordt verwacht.
Van toepassing op
ExtractToDirectoryAsync(String, String, TarExtractOptions, CancellationToken)
- Bron:
- TarFile.cs
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceFileName, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : string * string * System.Formats.Tar.TarExtractOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ExtractToDirectoryAsync (sourceFileName As String, destinationDirectoryName As String, options As TarExtractOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- 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
- cancellationToken
- CancellationToken
Retouren
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.
Uitzonderingen die optreden tijdens asynchrone extractie worden opgeslagen in de geretourneerde taak en worden gegenereerd wanneer de taak wordt verwacht.
