XmlWriter.WriteCharsAsync(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ě zapisuje text po jedné vyrovnávací paměti.
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.Task
Public Overridable Function WriteCharsAsync (buffer As Char(), index As Integer, count As Integer) As Task
Parametry
- buffer
- Char[]
Pole znaků obsahující text k zápisu
- index
- Int32
Pozice ve vyrovnávací paměti označující začátek textu, který se má zapisovat.
- count
- Int32
Počet znaků, které se mají napsat.
Návraty
Úloha, která představuje asynchronní WriteChars operaci.
Výjimky
Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".
nebo
Byla XmlWriter volána asynchronní metoda bez nastavení příznaku Async na true. V tomto případě je vyvolána se zprávou "Nastavit XmlWriterSettings.Async na true, InvalidOperationException pokud chcete použít asynchronní metody."
Poznámky
Jedná se o asynchronní verzi WriteChars, 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é WriteChars(Char[], Int32, Int32).