ZipArchive.CreateFromDirectory, méthode (String, String, CompressionLevel, Boolean)
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 inclut également 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.
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, _
compressionLevel As CompressionLevel, _
includeBaseDirectory As Boolean _
)
public static void CreateFromDirectory(
string sourceDirectoryName,
string destinationArchiveFileName,
CompressionLevel compressionLevel,
bool includeBaseDirectory
)
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.
- compressionLevel
Type : Microsoft.TeamFoundation.Server.Core.CompressionLevel
Le niveau de compression (vitesse/mémoire et compromis le compressé de taille).
- includeBaseDirectory
Type : System.Boolean
True pour indiquer qu'un répertoire nommé sourceDirectoryName doit être inclus à la racine de l'archive.False pour montrer que les fichiers et les répertoires dans le sourceDirectoryName doivent être inclus directement dans l'archive.
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.