XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) 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.
Lit de façon asynchrone des flux de texte volumineux incorporés dans un document XML.
public:
virtual System::Threading::Tasks::Task<int> ^ ReadValueChunkAsync(cli::array <char> ^ buffer, int index, int count);
public virtual System.Threading.Tasks.Task<int> ReadValueChunkAsync (char[] buffer, int index, int count);
abstract member ReadValueChunkAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
override this.ReadValueChunkAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
Public Overridable Function ReadValueChunkAsync (buffer As Char(), index As Integer, count As Integer) As Task(Of Integer)
Paramètres
- buffer
- Char[]
Tableau de caractères servant de mémoire tampon dans laquelle le texte est écrit. Cette valeur ne peut pas être null
.
- count
- Int32
Nombre maximal de caractères à copier dans la mémoire tampon. Le nombre réel de caractères copiés est retourné à partir de cette méthode.
Retours
Nombre total de caractères lus dans la mémoire tampon. La valeur zéro est retournée quand il n'y a plus de contenu de texte.
Exceptions
Une méthode XmlReader a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ». -ou-
Une méthode asynchrone XmlReader a été appelée sans définir l’indicateur Async sur true
. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Attribuez à XmlReaderSettings.Async la valeur True si vous voulez utiliser des méthodes asynchrones ».
Remarques
Il s’agit de la version asynchrone de ReadValueChunk, avec la même fonctionnalité. Pour utiliser cette méthode, vous devez définir l’indicateur sur Asynctrue
.