Sdílet prostřednictvím


XmlWriter.WriteCharsAsync(Char[], Int32, Int32) Metoda

Definice

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).

Platí pro

Viz také