ZipArchiveEntry.ExtractToFile, méthode (String)
Crée un fichier sur le système de fichiers avec le contenu et le nom spécifié de l'entrée. La dernière d'écriture du fichier est définie au dernier temps de l'écriture de l'entrée. Cette méthode ne permet pas le remplacement d'un fichier existant avec le même nom. La tentative pour récupérer les répertoires explicites (entrées avec des noms qui terminent dans caractères séparateurs de répertoire) n'aura pas entraîner la création d'un répertoire.
Espace de noms : Microsoft.TeamFoundation.Server.Core
Assembly : Microsoft.TeamFoundation.Server.Core (dans Microsoft.TeamFoundation.Server.Core.dll)
Syntaxe
'Déclaration
Public Sub ExtractToFile ( _
destinationFileName As String _
)
public void ExtractToFile(
string destinationFileName
)
Paramètres
- destinationFileName
Type : System.String
Nom du fichier qui contiendra le contenu de l'entrée.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.
Exceptions
| Exception | Condition |
|---|---|
| UnauthorizedAccessException | L'appelant n'a pas l'autorisation requise. |
| ArgumentException | le destinationFileName 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. - ou destinationFileName spécifie un répertoire. |
| ArgumentNullException | le destinationFileName est 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é dans le destinationFileName est valide (par exemple, il se trouve sur un lecteur a). |
| IOException | le destinationFileName existe. - ou une erreur E/S s'est produite. - ou l'entrée est actuellement ouverte en écriture. - ou l'entrée a été supprimée de l'archive. |
| NotSupportedException | le destinationFileName est pas un format correct (ou le ZipArchive que cette entrée appartient a été ouvert dans un mode en écriture seule. |
| InvalidDataException | L'entrée est manquante de l'archive ou endommagée et ne peut pas être lue (ou l'entrée a été compressée à l'aide d'une méthode de compression qui n'est pas prise en charge. |
| ObjectDisposedException | Le ZipArchive que cette entrée appartient a été supprimé. |
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.