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
| Name | 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.
- 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.
Het pad naar de destinationDirectoryName map is niet gevonden.
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
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.
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.
- 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.
Het pad naar de destinationDirectoryName map 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 –
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
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.
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
- options
- TarExtractOptions
- cancellationToken
- CancellationToken
Retouren
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
- options
- TarExtractOptions
- cancellationToken
- CancellationToken
