XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) Metódus

Definíció

Névtér:
System.Xml
Szerelvények:
System.Xml.dll, System.Xml.ReaderWriter.dll
Szerelvények:
netstandard.dll, System.Xml.ReaderWriter.dll
Szerelvény:
System.Xml.ReaderWriter.dll
Szerelvény:
System.Xml.dll
Szerelvény:
netstandard.dll
Forrás:
XmlReaderAsync.cs
Forrás:
XmlReaderAsync.cs
Forrás:
XmlReaderAsync.cs
Forrás:
XmlReaderAsync.cs
Forrás:
XmlReaderAsync.cs

Aszinkron módon beolvassa az XML-dokumentumokba beágyazott nagy szövegfolyamokat.

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éterek

buffer
Char[]

A szöveg tartalmát tartalmazó pufferként szolgáló karakterek tömbje. Ez az érték nem lehet null.

index
Int32

Az eltolás a pufferen belül, ahol a XmlReader fájl elkezdheti az eredmények másolását.

count
Int32

A pufferbe másolandó karakterek maximális száma. A program a másolt karakterek tényleges számát adja vissza ebből a metódusból.

Válaszok

Task<Int32>

A pufferbe beolvasott karakterek száma. A nulla érték akkor lesz visszaadva, ha nincs több szöveges tartalom.

Kivételek

InvalidOperationException

Egy XmlReader metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

Aszinkron XmlReader metódust hívtak meg anélkül, hogy a jelölőt a Async következőre trueállítanák. Ebben az esetben InvalidOperationException az "XmlReaderSettings.Async beállítása igazra" üzenet jelenik meg, ha aszinkron metódusokat szeretne használni.

Megjegyzések

Ez az aszinkron verzió ReadValueChunk, ugyanazzal a funkcióval. A metódus használatához be kell állítania a jelölőt a Async következőre true: .

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által ReadValueChunk(Char[], Int32, Int32)kiadott kivételeket: .

A következőre érvényes:

Lásd még