ZipFileExtensions.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.
Extrait tous les fichiers de l’archive dans un répertoire sur le système de fichiers. Le répertoire spécifié peut déjà exister.
Surcharges
| Nom | Description |
|---|---|
| ExtractToDirectoryAsync(ZipArchive, String, CancellationToken) |
Extrait de manière asynchrone tous les fichiers de l’archive dans un répertoire sur le système de fichiers. Le répertoire spécifié peut déjà exister. |
| ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken) |
Extrait tous les fichiers de l’archive dans un répertoire sur le système de fichiers. Le répertoire spécifié peut déjà exister. |
| ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken) |
ExtractToDirectoryAsync(ZipArchive, String, CancellationToken)
Extrait de manière asynchrone tous les fichiers de l’archive dans un répertoire sur le système de fichiers. Le répertoire spécifié peut déjà exister.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParamètres
- source
- ZipArchive
Archive zip à partir de laquelle extraire des fichiers.
- destinationDirectoryName
- String
Chemin d’accès au répertoire sur le système de fichiers. Le répertoire peut déjà exister. Les répertoires manquants sont créés en fonction des besoins lors de l’extraction d’entrées.
- cancellationToken
- CancellationToken
Jeton d’annulation à surveiller pour les demandes d’annulation.
Retours
Exceptions
destinationDirectoryName est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient un ou plusieurs caractères non valides tels que définis par InvalidPathChars.
destinationDirectoryName a la valeur null.
Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système. Par exemple, sur les plateformes Windows, les chemins d’accès doivent être inférieurs à 248 caractères, et les noms de fichiers doivent être inférieurs à 260 caractères.
Le chemin spécifié n’est pas valide (par exemple, il se trouve sur un lecteur non mappé).
Le nom d’une entrée d’archive est de longueur nulle, contient uniquement des espaces blancs ou contient un ou plusieurs caractères non valides tels que définis par InvalidPathChars.
- ou -
L’extraction d’une entrée d’archive aurait entraîné un fichier de destination qui se trouve en dehors destinationDirectoryName (par exemple, si le nom d’entrée contient des accesseurs de répertoire parent).
- ou -
Une entrée d’archive porte le même nom qu’une entrée déjà extraite de la même archive.
L’appelant n’a pas l’autorisation requise.
destinationDirectoryName est dans un format non valide.
Une entrée d’archive n’a pas été trouvée ou endommagée.
- ou -
Une entrée d’archive a été compressée à l’aide d’une méthode de compression qui n’est pas prise en charge.
Une opération asynchrone est annulé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.
Le répertoire spécifié par destinationDirectoryName peut déjà exister. Cette méthode crée le répertoire de destination, ses répertoires parents manquants et ses sous-répertoires si nécessaire lors de l’extraction d’entrées. Si l’archive est vide, cette méthode ne crée pas le répertoire de destination.
Le chemin d’accès est autorisé à spécifier des informations relatives ou absolues. Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel.
En cas d’erreur lors de l’extraction de l’archive, l’archive reste partiellement extraite.
Chaque entrée est extraite de sorte que le fichier extrait ait le même chemin relatif que destinationDirectoryName l’entrée à la racine de l’archive. Si un fichier à archiver a une heure de dernière modification non valide, la première datetime représentée au format d’horodatage Zip (minuit le 1er janvier 1980) sera utilisée.
S’applique à
ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken)
Extrait tous les fichiers de l’archive dans un répertoire sur le système de fichiers. Le répertoire spécifié peut déjà exister.
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParamètres
- source
- ZipArchive
Archive zip à partir de laquelle extraire des fichiers.
- destinationDirectoryName
- String
Chemin d’accès au répertoire sur le système de fichiers. Le répertoire peut déjà exister. Les répertoires manquants sont créés en fonction des besoins lors de l’extraction d’entrées.
- overwriteFiles
- Boolean
true pour remplacer les fichiers ; false Sinon.
- cancellationToken
- CancellationToken
Jeton d’annulation à surveiller pour les demandes d’annulation.
Retours
Exceptions
destinationDirectoryName est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient un ou plusieurs caractères non valides tels que définis par InvalidPathChars.
Cette méthode crée des répertoires manquants si nécessaire lors de l’extraction d’entrées.
En cas d’erreur lors de l’extraction de l’archive, l’archive reste partiellement extraite.
Chaque entrée est extraite de sorte que le fichier extrait ait le même chemin relatif que destinationDirectoryName l’entrée à la racine de l’archive. Si un fichier à archiver a une heure de dernière modification non valide, la première datetime représentée au format d’horodatage Zip (minuit le 1er janvier 1980) sera utilisée.
destinationDirectoryName a la valeur null.
Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.
Par exemple, sur les plateformes Windows, les chemins d’accès doivent être inférieurs à 248 caractères, et les noms de fichiers doivent être inférieurs à 260 caractères.
Le chemin spécifié n’est pas valide (par exemple, il se trouve sur un lecteur non mappé).
Le nom d’une entrée d’archive est de longueur nulle, contient uniquement des espaces blancs ou contient un ou plusieurs caractères non valides tels que définis par InvalidPathChars.
- ou -
L’extraction d’une entrée d’archive aurait entraîné un fichier de destination qui se trouve en dehors destinationDirectoryName (par exemple, si le nom d’entrée contient des accesseurs de répertoire parent).
- ou -
Une entrée d’archive porte le même nom qu’une entrée déjà extraite de la même archive.
L’appelant n’a pas l’autorisation requise.
destinationDirectoryName est dans un format non valide.
Une entrée d’archive n’a pas été trouvée ou endommagée.
- ou -
Une entrée d’archive a été compressée à l’aide d’une méthode de compression qui n’est pas prise en charge.
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.
Le répertoire spécifié par destinationDirectoryName peut déjà exister. Cette méthode crée le répertoire de destination, ses répertoires parents manquants et ses sous-répertoires si nécessaire lors de l’extraction d’entrées. Si l’archive est vide, cette méthode ne crée pas le répertoire de destination.
Le chemin d’accès est autorisé à spécifier des informations relatives ou absolues. Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel.
S’applique à
ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken)
public static System.Threading.Tasks.Task ExtractToDirectoryAsync(this System.IO.Compression.ZipArchive source, string destinationDirectoryName, System.IO.Compression.ZipExtractionOptions options, System.Threading.CancellationToken cancellationToken = default);static member ExtractToDirectoryAsync : System.IO.Compression.ZipArchive * string * System.IO.Compression.ZipExtractionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToDirectoryAsync (source As ZipArchive, destinationDirectoryName As String, options As ZipExtractionOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParamètres
- source
- ZipArchive
- destinationDirectoryName
- String
Chemin d’accès au répertoire dans lequel placer les fichiers extraits. Le répertoire peut déjà exister. Les répertoires manquants sont créés en fonction des besoins lors de l’extraction d’entrées.
- options
- ZipExtractionOptions
- cancellationToken
- CancellationToken
Retours
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.
Le répertoire spécifié par destinationDirectoryName peut déjà exister. Cette méthode crée le répertoire de destination, ses répertoires parents manquants et ses sous-répertoires si nécessaire lors de l’extraction d’entrées. Si l’archive est vide, cette méthode ne crée pas le répertoire de destination.
Chaque fichier extrait a le même chemin relatif que destinationDirectoryName son entrée source à la racine de l’archive.
Le destinationDirectoryName paramètre accepte les chemins relatifs et absolus. 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, ce qui entraîne l’extraction d’un IOException fichier à extraire déjà.
Permet Password de fournir le mot de passe pour les entrées chiffrées.
EntryNameEncoding n’est pas utilisé par cette surcharge. Les noms et commentaires d’entrée sont décodés à l’aide de l’encodage spécifié lors de l’ouverture de l’archive source .
Les liens symboliques dans l’archive ne sont pas recréés en tant que liens symboliques. Si destinationDirectoryName ou l’un de ses répertoires parents est une jonction ou un lien symbolique préexistant, le lien est suivi et les écritures d’extraction dans le dossier cible final.
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.
