ZipArchive.ExtractToDirectory, méthode (String, String)
Récupère tous les fichiers dans l'archive spécifiée dans un répertoire sur le système de fichiers. Répertoire spécifié ne doit pas exister. Cette méthode crée tous les sous-répertoires et le répertoire spécifié. S'il y a une erreur pendant la récupération d'archivage, l'archive reste partiellement récupérée. Chaque entrée sera récupérée tels que le fichier d'extraction extrait a le même chemin d'accès relatif au destinationDirectoryName que l'entrée doit l'archive. Le chemin d'accès est autorisé à spécifier les informations de parent ou de chemin d'accès absolu. Les informations sur le chemin d'accès relatif sont interprétées comme étant relatives au répertoire de travail actif. Si un fichier à archiver a une heure valide de dernière modification, le premier qui peut être représenté DateTime au format d'horodatage zip (minuit le 1er janvier 1980) est utilisé.
Espace de noms : Microsoft.TeamFoundation.Server.Core
Assembly : Microsoft.TeamFoundation.Server.Core (dans Microsoft.TeamFoundation.Server.Core.dll)
Syntaxe
'Déclaration
Public Shared Sub ExtractToDirectory ( _
sourceArchiveFileName As String, _
destinationDirectoryName As String _
)
public static void ExtractToDirectory(
string sourceArchiveFileName,
string destinationDirectoryName
)
Paramètres
- sourceArchiveFileName
Type : System.String
Le chemin d'accès à l'archive sur le système de fichiers qui doit être récupéré.
- destinationDirectoryName
Type : System.String
Le chemin d'accès au répertoire sur le système de fichiers.Répertoire spécifié ne doit pas exister, mais le répertoire qu'il est contenu dans doit exister.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentException | sourceArchive ou destinationDirectoryName est une chaîne de longueur nulle, ne contient que des espaces blancs, ou contient un ou plusieurs caractères non valides définie par InvalidPathChars. |
| ArgumentNullException | sourceArchive ou destinationDirectoryName est null. |
| PathTooLongException | sourceArchive ou destinationDirectoryName spécifie un chemin d'accès, 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 et les noms de fichiers ne doivent pas comporter plus de 248 et 260 caractères, respectivement. |
| DirectoryNotFoundException | Le chemin d'accès spécifié par sourceArchive ou le destinationDirectoryName est valide, (par exemple, il se trouve sur un lecteur a). |
| IOException | Répertoire spécifié par le destinationDirectoryName existe déjà. - ou une erreur E/S s'est produite. - ou un nom d'entrée d'archivage est de longueur nulle, ne contient que des espaces blancs, ou contient un ou plusieurs caractères non valides comme défini par InvalidPathChars. - ou l'extraction d'une entrée d'archivage entraînait une destination de fichier qui est en dehors du répertoire de destination (par exemple, en raison des accesseurs de répertoire parent). - ou une entrée d'archivage a le même nom qu'une entrée déjà récupérée du même archivent. |
| UnauthorizedAccessException | L'appelant n'a pas l'autorisation requise. |
| NotSupportedException | sourceArchive ou destinationDirectoryName a un format valide. |
| FileNotFoundException | sourceArchive est introuvable. |
| InvalidDataException | L'archivage spécifiée par sourceArchive : N'est pas un ZipArchive valide (ou une entrée d'archivage est introuvable ou a été endommagée. - ou une entrée d'archivage a été compressée à l'aide d'une méthode de compression qui n'est pas prise en charge. |
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.