XmlWriter.WriteDocTypeAsync(String, String, String, String) Método

Definição

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

Escreve assíncronamente a declaração DOCTYPE com o nome especificado e atributos opcionais.

public:
 virtual System::Threading::Tasks::Task ^ WriteDocTypeAsync(System::String ^ name, System::String ^ pubid, System::String ^ sysid, System::String ^ subset);
public virtual System.Threading.Tasks.Task WriteDocTypeAsync(string name, string pubid, string sysid, string subset);
abstract member WriteDocTypeAsync : string * string * string * string -> System.Threading.Tasks.Task
override this.WriteDocTypeAsync : string * string * string * string -> System.Threading.Tasks.Task
Public Overridable Function WriteDocTypeAsync (name As String, pubid As String, sysid As String, subset As String) As Task

Parâmetros

name
String

O nome do DOCTYPE. Isto deve não estar vazio.

pubid
String

Se não nulo, também escreve PUBLIC "pubid", "sysid", onde pubid e sysid são substituídos pelo valor dos argumentos dados.

sysid
String

Se pubid for null e sysid for não-nulo, escreve SYSTEM "sysid", onde sysid é substituído pelo valor deste argumento.

subset
String

Se não nulo, escreve [subconjunto] onde o subconjunto é substituído pelo valor deste argumento.

Devoluções

Task

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

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 WriteDocType, 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 WriteDocType(String, String, String, String).

Aplica-se a

Ver também