TarFile.CreateFromDirectoryAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken) |
Crée de manière asynchrone un flux tar qui contient toutes les entrées de système de fichiers du répertoire spécifié. |
CreateFromDirectoryAsync(String, String, Boolean, CancellationToken) |
Crée de manière asynchrone une archive tar à partir du contenu du répertoire spécifié et les génère dans le chemin spécifié. Peut éventuellement inclure le répertoire de base comme préfixe pour les noms d’entrée. |
CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken)
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- Source:
- TarFile.cs
Crée de manière asynchrone un flux tar qui contient toutes les entrées de système de fichiers du répertoire spécifié.
public static System.Threading.Tasks.Task CreateFromDirectoryAsync (string sourceDirectoryName, System.IO.Stream destination, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);
static member CreateFromDirectoryAsync : string * System.IO.Stream * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task
Paramètres
- sourceDirectoryName
- String
Chemin du répertoire à archiver.
- destination
- Stream
Flux de destination de l’archive.
- includeBaseDirectory
- Boolean
true
pour inclure le nom du répertoire de base comme premier segment de chemin d’accès dans tous les noms des entrées d’archive. false
pour exclure le nom du répertoire de base des chemins d’accès au nom d’entrée.
- cancellationToken
- CancellationToken
Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est None.
Retours
Tâche qui représente l’opération de création asynchrone.
Exceptions
sourceDirectoryName
ou destination
est null
.
sourceDirectoryName
est vide.
- ou -
destination
ne prend pas en charge l’écriture.
Le sourceDirectoryName
chemin du répertoire est introuvable.
Une exception d’E/S s’est produite.
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
Remarques
Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par CreateFromDirectory(String, Stream, Boolean).
S’applique à
CreateFromDirectoryAsync(String, String, Boolean, CancellationToken)
- Source:
- TarFile.cs
- Source:
- TarFile.cs
- Source:
- TarFile.cs
Crée de manière asynchrone une archive tar à partir du contenu du répertoire spécifié et les génère dans le chemin spécifié. Peut éventuellement inclure le répertoire de base comme préfixe pour les noms d’entrée.
public static System.Threading.Tasks.Task CreateFromDirectoryAsync (string sourceDirectoryName, string destinationFileName, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);
static member CreateFromDirectoryAsync : string * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationFileName As String, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task
Paramètres
- sourceDirectoryName
- String
Chemin du répertoire à archiver.
- destinationFileName
- String
Chemin d’accès du fichier d’archive de destination.
- includeBaseDirectory
- Boolean
true
pour inclure le nom du répertoire de base comme premier segment de chemin d’accès dans tous les noms des entrées d’archive. false
pour exclure le nom du répertoire de base des chemins d’accès au nom d’entrée.
- cancellationToken
- CancellationToken
Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est None.
Retours
Tâche qui représente l’opération de création asynchrone.
Exceptions
sourceDirectoryName
ou destinationFileName
est null
.
sourceDirectoryName
ou destinationFileName
est vide.
Le sourceDirectoryName
chemin du répertoire est introuvable.
Une exception d’E/S s’est produite.
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
Remarques
Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par CreateFromDirectory(String, String, Boolean).