ZipArchive, constructeur (String, ZipArchiveMode)
Ouvre un ZipArchive sur le chemin d'accès spécifié en mode spécifié de ZipArchiveMode.
Espace de noms : Microsoft.TeamFoundation.Server.Core
Assembly : Microsoft.TeamFoundation.Server.Core (dans Microsoft.TeamFoundation.Server.Core.dll)
Syntaxe
'Déclaration
Public Sub New ( _
archiveFileName As String, _
mode As ZipArchiveMode _
)
public ZipArchive(
string archiveFileName,
ZipArchiveMode mode
)
Paramètres
- archiveFileName
Type : System.String
Chaîne spécifiant le chemin d'accès du système de fichiers pour ouvrir l'archive activé.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.
- mode
Type : Microsoft.TeamFoundation.Server.Core.ZipArchiveMode
Consultez la description de l'enum du ZipArchiveMode.Si la lecture est spécifiée, il s'ouvre avec System.IO.FileMode.Open, et lève un FileNotFoundException si le fichier n'existe pas.Si Créer est spécifiée, il s'ouvre avec System.IO.FileMode.CreateNew, et lève un System.IO.IOException si le fichier existe déjà.Si la mise à jour est spécifiée, il s'ouvre avec System.IO.FileMode.OpenOrCreate.Si le fichier existe et est fichier ZIP, ses entrées sont accessibles, et peuvent être modifiées, et de nouvelles entrées peuvent être créées.Si le fichier existe et non un fichier ZIP, un ZipArchiveException sera levée.Si le fichier existe et est vide ou n'existe pas, un nouveau fichier ZIP est créé.Notez que crée un fichier ZIP avec mode de ZipArchiveMode.Create est plus efficace en créant un nouveau fichier.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentException | le chemin d'accès est une chaîne de longueur nulle, ne contient que des espaces blancs, ou contient un ou plusieurs caractères non valides comme défini par InvalidPathChars. |
| ArgumentNullException | path a la valeur null. |
| PathTooLongException | Le chemin d'accès, le nom de fichier spécifié 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é n'est pas valide (il se trouve, par exemple, sur un lecteur non mappé). |
| IOException | Une erreur d'E/S s'est produite lors de l'ouverture du fichier. |
| UnauthorizedAccessException | le chemin d'accès spécifié un répertoire. - ou l'appelant n'a pas l'autorisation requise. |
| ArgumentOutOfRangeException | mode avez spécifié une valeur valide. |
| FileNotFoundException | Le fichier spécifié dans le chemin d'accès est introuvable. |
| NotSupportedException | le chemin d'accès est dans un format valide. |
| InvalidDataException | Le fichier spécifié n'a pas pu être interprète comme un fichier. - ou mode est la mise à jour et une entrée est manquante de l'archive ou endommagée et ne peut pas être lue. - ou mode est la mise à jour et d'entrée est trop grande pour s'insérer dans la mémoire. |
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.