ZipArchive.CreateFromDirectory, méthode (String, String)
Crée une archive zip au chemin d'accès destinationArchive contenant des fichiers et des répertoires dans le répertoire spécifié par le sourceDirectoryName. La structure de répertoires est conservée dans l'archive, et une recherche récursive est faite pour les fichiers sont archivés. L'archivage ne doit pas exister. Si le répertoire est vide, une archive vide sera créée. Si un fichier du répertoire ne peut pas être ajouté à l'archive, l'archivage est incomplète on quitte et valide et la méthode lève une exception. Cette méthode ne contient pas le répertoire de base dans l'archive. Si une erreur est rencontrée en ajoutant des fichiers à l'archive, cette méthode cesse d'ajouter des fichiers et se terminera l'archive dans un état non valide. Les tracés sont autorisés à 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 dans l'archive a des données dans le champ d'heure d'écriture qui n'est pas un horodatage valide zip, une valeur d'indicateur du 1er janvier 1980 à minuit sera utilisée pour l'heure de la dernière modification du fichier.
Si une entrée portant le nom spécifié existe déjà dans l'archive, il crée une deuxième entrée ayant un nom identique. Comme aucun CompressionLevel n'est spécifié, la valeur par défaut fournie par l'implémentation de l'algorithme de compression sous-jacent sera utilisée ; ZipArchive n'activera pas sa propre valeur par défaut. (Actuellement, l'algorithme de compression sous-jacent est fourni par la classe System.IO.Compression.DeflateStream .)
Espace de noms : Microsoft.TeamFoundation.Server.Core
Assembly : Microsoft.TeamFoundation.Server.Core (dans Microsoft.TeamFoundation.Server.Core.dll)
Syntaxe
'Déclaration
Public Shared Sub CreateFromDirectory ( _
sourceDirectoryName As String, _
destinationArchiveFileName As String _
)
public static void CreateFromDirectory(
string sourceDirectoryName,
string destinationArchiveFileName
)
Paramètres
- sourceDirectoryName
Type : System.String
Le chemin d'accès au répertoire sur le système de fichiers à archiver.
- destinationArchiveFileName
Type : System.String
Nom de l'archive à créer.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentException | le sourceDirectoryName ou destinationArchive 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 | le sourceDirectoryName ou destinationArchive est null. |
| PathTooLongException | Dans le sourceDirectoryName ou destinationArchive, 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 sourceDirectoryName ou destinationArchive est valide, (par exemple, il se trouve sur un lecteur a). - ou spécifié par le sourceDirectoryName n'existe pas. |
| IOException | destinationArchive existe. - ou une erreur E/S s'est produite lors de l'ouverture d'un fichier à archiver. |
| UnauthorizedAccessException | destinationArchive a spécifié un répertoire. - ou l'appelant n'a pas l'autorisation requise. |
| NotSupportedException | le sourceDirectoryName ou destinationArchive a un format valide. |
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.