XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Liest asynchron große Textströme, die in ein XML-Dokument eingebettet sind.
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)Parameter
- buffer
- Char[]
Das Array von Zeichen, das als Puffer dient, in den der Textinhalt geschrieben wird. Dieser Wert darf nicht null sein.
- index
- Int32
Der Offset innerhalb des Puffers, in dem die XmlReader Ergebnisse kopiert werden können.
- count
- Int32
Die maximale Anzahl von Zeichen, die in den Puffer kopiert werden sollen. Die tatsächliche Anzahl der kopierten Zeichen wird von dieser Methode zurückgegeben.
Gibt zurück
Die Anzahl der Zeichen, die in den Puffer gelesen werden. Der Wert Null wird zurückgegeben, wenn kein Textinhalt mehr vorhanden ist.
Ausnahmen
Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt." -oder-
Eine XmlReader asynchrone Methode wurde aufgerufen, ohne die Async Kennzeichnung auf .true In diesem Fall wird die Meldung "Set XmlReaderSettings.Async to true" ausgelöst, InvalidOperationException wenn Sie Async-Methoden verwenden möchten.
Hinweise
Dies ist die asynchrone Version von ReadValueChunk, mit der gleichen Funktionalität. Um diese Methode zu verwenden, müssen Sie das Async Kennzeichen auf true.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von ReadValueChunk(Char[], Int32, Int32).
