XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Asynchronně čte velké datové proudy textu vložené do dokumentu 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)Parametry
- buffer
- Char[]
Pole znaků, které slouží jako vyrovnávací paměť, do které se textový obsah zapisuje. Tato hodnota nemůže být null.
- count
- Int32
Maximální počet znaků, které se mají zkopírovat do vyrovnávací paměti. Skutečný počet zkopírovaných znaků je vrácen z této metody.
Návraty
Počet znaků přečtených do vyrovnávací paměti. Hodnota nula se vrátí, pokud už neexistuje žádný textový obsah.
Výjimky
Před XmlReader dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán se zprávou "Asynchronní operace už probíhá". -nebo-
Byla XmlReader volána asynchronní metoda bez nastavení příznaku Async na true. V tomto případě je vyvolána se zprávou "Set XmlReaderSettings.Async na true, InvalidOperationException pokud chcete použít asynchronní metody."
Poznámky
Jedná se o asynchronní verzi ReadValueChunk, se stejnou funkcí. Chcete-li použít tuto metodu Async , je nutné nastavit příznak na true.
Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané ReadValueChunk(Char[], Int32, Int32).
