TarFile.ExtractToDirectoryAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| Nom | Description |
|---|---|
| ExtractToDirectoryAsync(String, String, Boolean, CancellationToken) |
Extrait de façon asynchrone le contenu d’un fichier tar dans le répertoire spécifié. |
| ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken) |
Extrait de manière asynchrone le contenu d’un flux qui représente une archive tar dans le répertoire spécifié. |
| ExtractToDirectoryAsync(Stream, String, TarExtractOptions, CancellationToken) | |
| ExtractToDirectoryAsync(String, String, TarExtractOptions, CancellationToken) |
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- Source:
- TarFile.cs
Extrait de façon asynchrone le contenu d’un fichier tar dans le répertoire spécifié.
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 TaskParamètres
- sourceFileName
- String
Chemin du fichier tar à extraire.
- destinationDirectoryName
- String
Chemin d’accès du répertoire de destination où les entrées du système de fichiers doivent être extraites. Dans .NET 11 et versions antérieures, le répertoire doit déjà exister. Dans .NET versions 12 et ultérieures, les répertoires de destination et parents manquants sont créés si nécessaire lorsque les entrées sont extraites. Une archive vide ne crée aucun répertoire.
- overwriteFiles
- Boolean
true pour remplacer les fichiers et les répertoires dans destinationDirectoryName; false pour éviter le remplacement et lever si des fichiers ou répertoires sont trouvés avec des noms existants.
- cancellationToken
- CancellationToken
Jeton à surveiller pour les demandes d’annulation. La valeur par défaut est None.
Retours
Tâche qui représente l’opération d’extraction asynchrone.
Exceptions
sourceFileName ou destinationDirectoryName est null.
.NET 11 et versions antérieures : le destinationDirectoryName répertoire n’existe pas.
Le sourceFileName chemin d’accès au fichier est introuvable.
Les autorisations sont insuffisantes.
L’extraction de l’une des entrées tar aurait entraîné un fichier en dehors du répertoire de destination spécifié.
- ou -
sourceFileName ou destinationDirectoryName est vide.
.NET 11 et versions ultérieures uniquement : la somme de contrôle d'une entrée n'est pas valide.
Une exception d’E/S s’est produite.
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
Remarques
Warning
Cette méthode ne doit pas être utilisée pour extraire des archives non approuvées. Elle n’applique aucune limite de taille, limite de nombre d’entrées ou autres stratégies nécessaires à l’extraction sécurisée d’archives non approuvées. Pour plus d’informations sur l’extraction sécurisée d’archives provenant de sources non approuvées, consultez les meilleures pratiques pour l’utilisation des archives zip et tar.
Dans .NET 11 et versions antérieures, le répertoire spécifié par destinationDirectoryName doit déjà exister. S’il n’existe pas, cette méthode lève une DirectoryNotFoundExceptionexception , même si l’archive est vide.
Dans .NET 12 et versions ultérieures, le répertoire de destination peut déjà exister. Les répertoires de destination et parents manquants sont créés si nécessaire lorsque les entrées sont extraites. Une archive vide ne crée aucun répertoire.
Si un lien symbolique ou une jonction dans l’archive tar entraîne l’extraction d’un fichier en dehors du fichier spécifié destinationDirectoryName, il IOException est levée pour garantir que l’extraction reste dans le même répertoire.
Si destinationDirectoryName ou l’un de ses répertoires parents est une jonction ou un lien symbolique préexistant, le lien est suivi et l’extraction écrit dans le dossier cible final.
Les fichiers de type BlockDevice, CharacterDeviceou Fifo ne peuvent être extraits que dans les plateformes Unix.
L’élévation est requise pour extraire un disque ou BlockDevice un CharacterDevice disque.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par ExtractToDirectory(String, String, Boolean).
S’applique à
ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- Source:
- TarFile.cs
Extrait de manière asynchrone le contenu d’un flux qui représente une archive tar dans le répertoire spécifié.
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 TaskParamètres
- source
- Stream
Flux contenant l’archive tar.
- destinationDirectoryName
- String
Chemin d’accès du répertoire de destination où les entrées du système de fichiers doivent être extraites. Dans .NET 11 et versions antérieures, le répertoire doit déjà exister. Dans .NET versions 12 et ultérieures, les répertoires de destination et parents manquants sont créés si nécessaire lorsque les entrées sont extraites. Une archive vide ne crée aucun répertoire.
- overwriteFiles
- Boolean
true pour remplacer les fichiers et les répertoires dans destinationDirectoryName; false pour éviter le remplacement et lever si des fichiers ou répertoires sont trouvés avec des noms existants.
- cancellationToken
- CancellationToken
Jeton à surveiller pour les demandes d’annulation. La valeur par défaut est None.
Retours
Tâche qui représente l’opération d’extraction asynchrone.
Exceptions
source ou destinationDirectoryName est null.
.NET 11 et versions antérieures : le destinationDirectoryName répertoire n’existe pas.
Les autorisations sont insuffisantes.
L’extraction de l’une des entrées tar aurait entraîné un fichier en dehors du répertoire de destination spécifié.
- ou -
destinationDirectoryName est vide.
- ou -
source ne prend pas en charge la lecture.
.NET 11 et versions ultérieures uniquement : la somme de contrôle d'une entrée n'est pas valide.
Une exception d’E/S s’est produite.
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
Remarques
Warning
Cette méthode ne doit pas être utilisée pour extraire des archives non approuvées. Elle n’applique aucune limite de taille, limite de nombre d’entrées ou autres stratégies nécessaires à l’extraction sécurisée d’archives non approuvées. Pour plus d’informations sur l’extraction sécurisée d’archives provenant de sources non approuvées, consultez les meilleures pratiques pour l’utilisation des archives zip et tar.
Dans .NET 11 et versions antérieures, le répertoire spécifié par destinationDirectoryName doit déjà exister. S’il n’existe pas, cette méthode lève une DirectoryNotFoundExceptionexception , même si l’archive est vide.
Dans .NET 12 et versions ultérieures, le répertoire de destination peut déjà exister. Les répertoires de destination et parents manquants sont créés si nécessaire lorsque les entrées sont extraites. Une archive vide ne crée aucun répertoire.
Si un lien symbolique ou une jonction dans l’archive tar entraîne l’extraction d’un fichier en dehors du fichier spécifié destinationDirectoryName, il IOException est levée pour garantir que l’extraction reste dans le même répertoire.
Si destinationDirectoryName ou l’un de ses répertoires parents est une jonction ou un lien symbolique préexistant, le lien est suivi et l’extraction écrit dans le dossier cible final.
Les fichiers de type BlockDevice, CharacterDeviceou Fifo ne peuvent être extraits que dans les plateformes Unix.
L’élévation est requise pour extraire un disque ou BlockDevice un CharacterDevice disque.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par ExtractToDirectory(Stream, String, Boolean).
S’applique à
ExtractToDirectoryAsync(Stream, String, TarExtractOptions, CancellationToken)
- Source:
- 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 TaskParamètres
- source
- Stream
- destinationDirectoryName
- String
Chemin d’accès au répertoire dans lequel placer les fichiers extraits. Dans .NET 11 et versions antérieures, le répertoire doit déjà exister. Dans .NET versions 12 et ultérieures, les répertoires de destination et parents manquants sont créés si nécessaire lorsque les entrées sont extraites. Une archive vide ne crée aucun répertoire.
- options
- TarExtractOptions
- cancellationToken
- CancellationToken
Retours
Exceptions
.NET 11 et versions antérieures : le destinationDirectoryName répertoire n’existe pas.
Remarques
Warning
Cette méthode ne doit pas être utilisée pour extraire des archives non approuvées. Elle n’applique aucune limite de taille, limite de nombre d’entrées ou autres stratégies nécessaires à l’extraction sécurisée d’archives non approuvées. Pour plus d’informations sur l’extraction sécurisée d’archives provenant de sources non approuvées, consultez les meilleures pratiques pour l’utilisation des archives zip et tar.
Dans .NET 11 et versions antérieures, le répertoire spécifié par destinationDirectoryName doit déjà exister. S’il n’existe pas, cette méthode lève une DirectoryNotFoundExceptionexception , même si l’archive est vide.
Dans .NET 12 et versions ultérieures, le répertoire de destination peut déjà exister. Les répertoires de destination et parents manquants sont créés si nécessaire lorsque les entrées sont extraites. Une archive vide ne crée aucun répertoire.
Le chemin peut être relatif ou absolu. Un chemin relatif est interprété comme relatif au répertoire de travail actuel.
Si une erreur se produit lors de l’extraction, l’archive reste partiellement extraite.
Définissez cette option OverwriteFiles pour true remplacer les fichiers existants. La valeur par défaut est false. Permet HardLinkMode de contrôler l’extraction des entrées de lien dur.
Si un lien symbolique ou une jonction dans l’archive tar entraîne l’extraction d’un fichier en dehors du fichier spécifié destinationDirectoryName, il IOException est levée pour garantir que l’extraction reste dans le même répertoire.
Si destinationDirectoryName ou l’un de ses répertoires parents est une jonction ou un lien symbolique préexistant, le lien est suivi et l’extraction écrit dans le dossier cible final.
Les fichiers de type BlockDevice, CharacterDeviceou Fifo ne peuvent être extraits que dans les plateformes Unix.
L’élévation est requise pour extraire un disque ou BlockDevice un CharacterDevice disque.
Le source flux est laissé ouvert après l’extraction.
Les exceptions qui se produisent pendant l’extraction asynchrone sont stockées dans la tâche retournée et sont levées lorsque la tâche est attendue.
S’applique à
ExtractToDirectoryAsync(String, String, TarExtractOptions, CancellationToken)
- Source:
- 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 TaskParamètres
- sourceFileName
- String
- destinationDirectoryName
- String
Chemin d’accès au répertoire dans lequel placer les fichiers extraits. Dans .NET 11 et versions antérieures, le répertoire doit déjà exister. Dans .NET versions 12 et ultérieures, les répertoires de destination et parents manquants sont créés si nécessaire lorsque les entrées sont extraites. Une archive vide ne crée aucun répertoire.
- options
- TarExtractOptions
- cancellationToken
- CancellationToken
Retours
Exceptions
.NET 11 et versions antérieures : le destinationDirectoryName répertoire n’existe pas.
Remarques
Warning
Cette méthode ne doit pas être utilisée pour extraire des archives non approuvées. Elle n’applique aucune limite de taille, limite de nombre d’entrées ou autres stratégies nécessaires à l’extraction sécurisée d’archives non approuvées. Pour plus d’informations sur l’extraction sécurisée d’archives provenant de sources non approuvées, consultez les meilleures pratiques pour l’utilisation des archives zip et tar.
Dans .NET 11 et versions antérieures, le répertoire spécifié par destinationDirectoryName doit déjà exister. S’il n’existe pas, cette méthode lève une DirectoryNotFoundExceptionexception , même si l’archive est vide.
Dans .NET 12 et versions ultérieures, le répertoire de destination peut déjà exister. Les répertoires de destination et parents manquants sont créés si nécessaire lorsque les entrées sont extraites. Une archive vide ne crée aucun répertoire.
Le chemin peut être relatif ou absolu. Un chemin relatif est interprété comme relatif au répertoire de travail actuel.
Si une erreur se produit lors de l’extraction, l’archive reste partiellement extraite.
Définissez cette option OverwriteFiles pour true remplacer les fichiers existants. La valeur par défaut est false. Permet HardLinkMode de contrôler l’extraction des entrées de lien dur.
Si un lien symbolique ou une jonction dans l’archive tar entraîne l’extraction d’un fichier en dehors du fichier spécifié destinationDirectoryName, il IOException est levée pour garantir que l’extraction reste dans le même répertoire.
Si destinationDirectoryName ou l’un de ses répertoires parents est une jonction ou un lien symbolique préexistant, le lien est suivi et l’extraction écrit dans le dossier cible final.
Les fichiers de type BlockDevice, CharacterDeviceou Fifo ne peuvent être extraits que dans les plateformes Unix.
L’élévation est requise pour extraire un disque ou BlockDevice un CharacterDevice disque.
Les exceptions qui se produisent pendant l’extraction asynchrone sont stockées dans la tâche retournée et sont levées lorsque la tâche est attendue.
