XmlWriter.WriteCharsAsync(Char[], Int32, Int32) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Asynchronicznie zapisuje tekst po jednym buforze naraz.
public:
virtual System::Threading::Tasks::Task ^ WriteCharsAsync(cli::array <char> ^ buffer, int index, int count);public virtual System.Threading.Tasks.Task WriteCharsAsync(char[] buffer, int index, int count);abstract member WriteCharsAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteCharsAsync : char[] * int * int -> System.Threading.Tasks.TaskPublic Overridable Function WriteCharsAsync (buffer As Char(), index As Integer, count As Integer) As TaskParametry
- buffer
- Char[]
Tablica znaków zawierająca tekst do zapisu.
- index
- Int32
Pozycja w buforze wskazująca początek tekstu do zapisu.
- count
- Int32
Liczba znaków do zapisania.
Zwraca
Zadanie reprezentujące operację asynchroniczną WriteChars .
Wyjątki
Metoda XmlWriter została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".
— lub —
Wywołano XmlWriter metodę asynchroniczną bez ustawienia flagi Async na true. W takim przypadku zostanie zgłoszony komunikat "Ustaw wartość XmlWriterSettings.Async na wartość true, InvalidOperationException jeśli chcesz użyć metod asynchronicznych".
Uwagi
Jest to asynchroniczna wersja WriteCharsprogramu , z tą samą funkcjonalnością. Aby użyć tej metody, należy ustawić flagę Async na true.
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program WriteChars(Char[], Int32, Int32).
