TarReader.GetNextEntryAsync(Boolean, CancellationToken) 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.
Récupère de façon asynchrone l’entrée suivante à partir du flux d’archivage.
public System.Threading.Tasks.ValueTask<System.Formats.Tar.TarEntry?> GetNextEntryAsync(bool copyData = false, System.Threading.CancellationToken cancellationToken = default);member this.GetNextEntryAsync : bool * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Formats.Tar.TarEntry>Public Function GetNextEntryAsync (Optional copyData As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TarEntry)Paramètres
- copyData
- Boolean
true pour copier les données de l’entrée dans un nouveau MemoryStream. Cela est utile lorsque le flux d’archivage sous-jacent ne prend pas en charge la recherche et que les données doivent être accessibles ultérieurement.
false si les données ne doivent pas être copiées dans un nouveau flux. Si le flux sous-jacent ne prend pas en charge la recherche, l’utilisateur a la responsabilité de lire et de traiter immédiatement DataStream après l’appel de cette méthode.
La valeur par défaut est false.
- cancellationToken
- CancellationToken
Jeton à surveiller pour les demandes d’annulation. La valeur par défaut est None.
Retours
Tâche de valeur contenant une TarEntry instance si une entrée valide a été trouvée ou null si la fin de l’archive a été atteinte.
Exceptions
L’archive est incorrecte.
- ou -
L’archive contient des entrées dans différents formats.
- ou -
Plusieurs entrées d’attributs étendus globaux ont été trouvées dans l’archive actuelle Pax .
- ou -
Deux ou plusieurs entrées d’attributs étendus ont été trouvées consécutivement dans l’archive actuelle Pax .
- ou -
.NET 11 et versions ultérieures uniquement : la somme de contrôle d'une entrée n'est pas valide.
Un problème d’E/S s’est produit.
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 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par GetNextEntry(Boolean).
