XmlWriter.WriteCharsAsync(Char[], Int32, Int32) Método

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblagens:
netstandard.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll
Origem:
XmlWriterAsync.cs
Origem:
XmlWriterAsync.cs
Origem:
XmlWriterAsync.cs
Origem:
XmlWriterAsync.cs
Origem:
XmlWriterAsync.cs

O texto escreve assíncronamente um buffer de cada vez.

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

Parâmetros

buffer
Char[]

Array de caracteres contendo o texto a escrever.

index
Int32

A posição no buffer indica o início do texto a escrever.

count
Int32

O número de caracteres a escrever.

Devoluções

Task

A tarefa que representa a operação assíncrona WriteChars .

Exceções

InvalidOperationException

Um XmlWriter método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

-ou-

Um XmlWriter método assíncrono era chamado sem definir a Async flag para true. Neste caso, InvalidOperationException aparece com a mensagem "Definir XmlWriterSettings.Async como true se quiseres usar Métodos Assíncronos."

Observações

Esta é a versão assíncrona de WriteChars, com a mesma funcionalidade. Para usar este método, deve definir o Async flag para true.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por WriteChars(Char[], Int32, Int32).

Aplica-se a

Ver também