Partager via


TarFile.CreateFromDirectoryAsync Méthode

Définition

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).

S’applique à