XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Läser asynkront stora strömmar av text som är inbäddade i ett XML-dokument.
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)Parametrar
- buffer
- Char[]
Matrisen med tecken som fungerar som bufferten som textinnehållet skrivs till. Det här värdet får inte vara null.
- count
- Int32
Det maximala antalet tecken som ska kopieras till bufferten. Det faktiska antalet tecken som kopieras returneras från den här metoden.
Returer
Antalet tecken som läse in i bufferten. Värdet noll returneras när det inte finns något mer textinnehåll.
Undantag
En XmlReader metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras med meddelandet "En asynkron åtgärd pågår redan." -or-
En XmlReader asynkron metod anropades utan att flaggan sattes Async till true. I det här fallet InvalidOperationException genereras meddelandet "Ange XmlReaderSettings.Async till sant om du vill använda Async-metoder".
Kommentarer
Det här är den asynkrona versionen av ReadValueChunk, med samma funktioner. Om du vill använda den här metoden måste du ange Async flaggan till true.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av ReadValueChunk(Char[], Int32, Int32).
