XmlWriter Classe

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Origem:

XmlWriter.cs

Representa um gravador que fornece uma maneira rápida, não armazenada em cache e somente de encaminhamento de gerar fluxos ou arquivos que contém dados XML.

public ref class XmlWriter abstract : IAsyncDisposable, IDisposable

public abstract class XmlWriter : IAsyncDisposable, IDisposable

type XmlWriter = class
    interface IAsyncDisposable
    interface IDisposable

Public MustInherit Class XmlWriter
Implements IAsyncDisposable, IDisposable

Herança

Object

XmlWriter

Derivado

System.Xml.XmlDictionaryWriter

System.Xml.XmlTextWriter

System.Xml.Xsl.Runtime.XmlQueryOutput

Implementações

IDisposable IAsyncDisposable

Exemplos

O código de exemplo a seguir mostra como usar a API assíncrona para gerar XML.

async Task TestWriter(Stream stream)
{
    XmlWriterSettings settings = new XmlWriterSettings();
    settings.Async = true;

    using (XmlWriter writer = XmlWriter.Create(stream, settings)) {
        await writer.WriteStartElementAsync("pf", "root", "http://ns");
        await writer.WriteStartElementAsync(null, "sub", null);
        await writer.WriteAttributeStringAsync(null, "att", null, "val");
        await writer.WriteStringAsync("text");
        await writer.WriteEndElementAsync();
        await writer.WriteProcessingInstructionAsync("pName", "pValue");
        await writer.WriteCommentAsync("cValue");
        await writer.WriteCDataAsync("cdata value");
        await writer.WriteEndElementAsync();
        await writer.FlushAsync();
    }
}

Comentários

Para obter mais informações sobre essa API, consulte Comentários de API complementares para XmlWriter.

Construtores

XmlWriter()

Inicializa uma nova instância da classe XmlWriter.

Propriedades

Settings	Obtém o objeto XmlWriterSettings usado para criar essa instância XmlWriter.
WriteState	Quando substituído em uma classe derivada, obtém o estado do gravador.
XmlLang	Quando substituído em uma classe derivada, obtém o escopo xml:lang atual.
XmlSpace	Quando substituído em uma classe derivada, obtém um XmlSpace que representa o escopo xml:space atual.

Métodos

Close()	Quando substituído em uma classe derivada, fecha este fluxo e o fluxo subjacente.
Create(Stream)	Cria uma nova instância de XmlWriter usando o fluxo especificado.
Create(Stream, XmlWriterSettings)	Cria uma nova instância do XmlWriter usando o fluxo e o objeto XmlWriterSettings.
Create(String)	Cria uma nova instância XmlWriter usando o nome de arquivo especificado.
Create(String, XmlWriterSettings)	Cria uma nova XmlWriter instância usando o nome do arquivo e XmlWriterSettings objeto.
Create(StringBuilder)	Cria uma nova instância XmlWriter usando o StringBuilder especificado.
Create(StringBuilder, XmlWriterSettings)	Cria uma nova instância do XmlWriter usando os objetos StringBuilder e XmlWriterSettings.
Create(TextWriter)	Cria uma nova instância XmlWriter usando o TextWriter especificado.
Create(TextWriter, XmlWriterSettings)	Cria uma nova instância do XmlWriter usando os objetos TextWriter e XmlWriterSettings.
Create(XmlWriter)	Cria uma nova instância XmlWriter usando o objeto XmlWriter especificado.
Create(XmlWriter, XmlWriterSettings)	Cria uma nova instância XmlWriter usando os objetos XmlWriter e XmlWriterSettings especificados.
Dispose()	Libera todos os recursos usados pela instância atual da classe XmlWriter.
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo XmlWriter e opcionalmente libera os recursos gerenciados.
DisposeAsync()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados de forma assíncrona.
DisposeAsyncCore()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos gerenciados de forma assíncrona.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Flush()	Quando substituído em uma classe derivada, libera o que está no buffer para os fluxos subjacentes e também libera o fluxo subjacente.
FlushAsync()	Libera de maneira assíncrona tudo o que está no buffer para os fluxos subjacentes e também libera o fluxo subjacente.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LookupPrefix(String)	Quando substituído em uma classe derivada, retorna o prefixo mais próximo definido no escopo do namespace atual para o URI de namespace.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
WriteAttributes(XmlReader, Boolean)	Quando substituído em uma classe derivada, grava todos os atributos localizados na posição atual no XmlReader.
WriteAttributesAsync(XmlReader, Boolean)	Grava de forma assíncrona todos os atributos encontrados na posição atual no XmlReader.
WriteAttributeString(String, String)	Quando substituído em uma classe derivada, grava o atributo com o nome local e o valor especificados.
WriteAttributeString(String, String, String)	Quando substituído em uma classe derivada, grava um atributo com o nome local, URI do namespace e o valor especificados.
WriteAttributeString(String, String, String, String)	Quando substituído em uma classe derivada, grava o atributo com o prefixo, nome local, URI do namespace e o valor especificados.
WriteAttributeStringAsync(String, String, String, String)	Grava de forma assíncrona o atributo com o prefixo especificado, o nome local, o URI de namespace e o valor.
WriteBase64(Byte[], Int32, Int32)	Quando substituído em uma classe derivada, codifica os bytes binários especificados como Base64 e grava o texto resultante.
WriteBase64Async(Byte[], Int32, Int32)	Codifica de forma assíncrona os bytes binários especificados como Base64 e grava o texto resultante.
WriteBinHex(Byte[], Int32, Int32)	Quando substituído em uma classe derivada, codifica os bytes binários especificados como BinHex e grava o texto resultante.
WriteBinHexAsync(Byte[], Int32, Int32)	Codifica de forma assíncrona os bytes binários especificados como BinHex e grava o texto resultante.
WriteCData(String)	Quando substituído em uma classe derivada, grava um bloco <![CDATA[...]]> que contém o texto especificado.
WriteCDataAsync(String)	Grava de forma assíncrona um bloco <![CDATA[...]]> que contém o texto especificado.
WriteCharEntity(Char)	Quando substituído em uma classe derivada, força a geração de uma entidade de caracteres para o valor especificado de caracteres Unicode.
WriteCharEntityAsync(Char)	Força de forma assíncrona a geração de uma entidade de caracteres para o valor de caractere Unicode especificado.
WriteChars(Char[], Int32, Int32)	Quando substituído em uma classe derivada, grava texto um buffer por vez.
WriteCharsAsync(Char[], Int32, Int32)	Grava texto de forma assíncrona um buffer por vez.
WriteComment(String)	Quando substituído em uma classe derivada, grava um comentário <!--...--> que contém o texto especificado.
WriteCommentAsync(String)	Grava de forma assíncrona um comentário <!--...--> que contém o texto especificado.
WriteDocType(String, String, String, String)	Quando substituído em uma classe derivada, grava a declaração DOCTYPE com o nome especificado e os atributos opcionais.
WriteDocTypeAsync(String, String, String, String)	Grava de forma assíncrona a declaração DOCTYPE com o nome especificado e os atributos opcionais.
WriteElementString(String, String)	Grava um elemento com o valor e o nome local especificados.
WriteElementString(String, String, String)	Grava um elemento com o nome local, URI de namespace e valor especificados.
WriteElementString(String, String, String, String)	Grava um elemento com o prefixo, o nome local, o URI do namespace e o valor especificados.
WriteElementStringAsync(String, String, String, String)	Grava de forma assíncrona um elemento com o prefixo especificado, o nome local, o URI de namespace e o valor.
WriteEndAttribute()	Quando substituído em uma classe derivada, fecha a chamada WriteStartAttribute(String, String) anterior.
WriteEndAttributeAsync()	Fecha de forma assíncrona a chamada WriteStartAttribute(String, String) anterior.
WriteEndDocument()	Quando substituído em uma classe derivada, fecha todos os elementos ou atributos abertos e coloca o gravador de volta no estado Inicial.
WriteEndDocumentAsync()	Fecha de forma assíncrona os elementos ou atributos abertos e coloca o gravador de volta no estado Inicial.
WriteEndElement()	Quando substituído em uma classe derivada, fecha um elemento e aciona o escopo de namespace correspondente.
WriteEndElementAsync()	Fecha de forma assíncrona um elemento e remove o escopo de namespace correspondente da pilha.
WriteEntityRef(String)	Quando substituído em uma classe derivada, grava uma referência de entidade como &name;.
WriteEntityRefAsync(String)	Grava de forma assíncrona uma referência de entidade como &name;.
WriteFullEndElement()	Quando substituído em uma classe derivada, fecha um elemento e aciona o escopo de namespace correspondente.
WriteFullEndElementAsync()	Fecha de forma assíncrona um elemento e remove o escopo de namespace correspondente da pilha.
WriteName(String)	Quando substituído em uma classe derivada, grava o nome especificado, garantindo que ele seja um nome válido de acordo com a recomendação do W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNameAsync(String)	Grava de forma assíncrona o nome especificado, garantindo que ele seja um nome válido de acordo com a recomendação do W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmToken(String)	Quando substituído em uma classe derivada, grava o nome especificado, garantindo que ele seja um NmToken válido de acordo com a recomendação do W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmTokenAsync(String)	Grava de forma assíncrona o nome especificado, garantindo que ele seja um NmToken válido de acordo com a recomendação do W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNode(XmlReader, Boolean)	Quando substituído em uma classe derivada, copia tudo do leitor no gravador e move o leitor para o início do próximo irmão.
WriteNode(XPathNavigator, Boolean)	Copia tudo do objeto XPathNavigator no gravador. A posição do XPathNavigator permanece inalterada.
WriteNodeAsync(XmlReader, Boolean)	Copia de forma assíncrona tudo do leitor no gravador e move o leitor para o início do próximo irmão.
WriteNodeAsync(XPathNavigator, Boolean)	Copia de forma assíncrona tudo do objeto XPathNavigator para o gravador. A posição do XPathNavigator permanece inalterada.
WriteProcessingInstruction(String, String)	Quando substituído em uma classe derivada, grava uma instrução de processamento com um espaço entre o nome e o texto da seguinte maneira: <?nome texto?>.
WriteProcessingInstructionAsync(String, String)	Grava de forma assíncrona uma instrução de processamento com um espaço entre o nome e o texto da seguinte maneira: <? nome texto?>.
WriteQualifiedName(String, String)	Quando substituído em uma classe derivada, grava o nome qualificado do namespace. Este método pesquisa o prefixo que está no escopo para o namespace fornecido.
WriteQualifiedNameAsync(String, String)	Grava de forma assíncrona o nome qualificado do namespace. Este método pesquisa o prefixo que está no escopo para o namespace fornecido.
WriteRaw(Char[], Int32, Int32)	Quando substituído em uma classe derivada, grava a marcação bruta manualmente de um buffer de caracteres.
WriteRaw(String)	Quando substituído em uma classe derivada, grava manualmente a marcação bruta de uma cadeia de caracteres.
WriteRawAsync(Char[], Int32, Int32)	Grava de forma assíncrona e manual a marcação bruta de um buffer de caracteres.
WriteRawAsync(String)	Grava de forma assíncrona e manual a marcação bruta de uma cadeia de caracteres.
WriteStartAttribute(String)	Grava o início de um atributo com o nome do local especificado.
WriteStartAttribute(String, String)	Grava o início de um atributo com o nome do local e o URI de namespace especificados.
WriteStartAttribute(String, String, String)	Quando substituído em uma classe derivada, grava o início de um atributo com o prefixo especificado, o nome local e o URI de namespace.
WriteStartAttributeAsync(String, String, String)	Grava de forma assíncrona o início de um atributo com o prefixo, o nome local e o URI de namespace especificados.
WriteStartDocument()	Quando substituído em uma classe derivada, grava a declaração XML com a versão "1.0".
WriteStartDocument(Boolean)	Quando substituído em uma classe derivada, grava a declaração XML com a versão "1.0" e o atributo autônomo.
WriteStartDocumentAsync()	Grava de forma assíncrona a declaração XML com a versão “1.0”.
WriteStartDocumentAsync(Boolean)	Grava de forma assíncrona a declaração XML com a versão “1.0” e o atributo autônomo.
WriteStartElement(String)	Quando substituído em uma classe derivada, grava uma marca de início com o nome local especificado.
WriteStartElement(String, String)	Quando substituído em uma classe derivada, grava a marca de início especificada e a associa ao namespace específico.
WriteStartElement(String, String, String)	Quando substituído em uma classe derivada, grava a marca de início especificada e a associa ao prefixo e ao namespace específicos.
WriteStartElementAsync(String, String, String)	Grava de forma assíncrona a marca de início especificada e a associa ao namespace e ao prefixo fornecidos.
WriteString(String)	Quando substituído em uma classe derivada, grava o conteúdo de texto especificado.
WriteStringAsync(String)	Grava de forma assíncrona o conteúdo de texto fornecido.
WriteSurrogateCharEntity(Char, Char)	Quando substituído em uma classe derivada, gera e grava a entidade de caracteres alternativos para o par de caracteres alternativos.
WriteSurrogateCharEntityAsync(Char, Char)	Gera e grava a entidade de caracteres alternativos de forma assíncrona para o par de caracteres alternativos.
WriteValue(Boolean)	Grava um valor Boolean.
WriteValue(DateTime)	Grava um valor DateTime.
WriteValue(DateTimeOffset)	Grava um valor DateTimeOffset.
WriteValue(Decimal)	Grava um valor Decimal.
WriteValue(Double)	Grava um valor Double.
WriteValue(Int32)	Grava um valor Int32.
WriteValue(Int64)	Grava um valor Int64.
WriteValue(Object)	Grava o valor do objeto.
WriteValue(Single)	Grava um número de ponto flutuante de precisão simples.
WriteValue(String)	Grava um valor String.
WriteWhitespace(String)	Quando substituído em uma classe derivada, grava o espaço em branco determinado.
WriteWhitespaceAsync(String)	Grava de forma assíncrona o espaço em branco determinado.

Métodos de Extensão

ConfigureAwait(IAsyncDisposable, Boolean)

Configura como as esperas nas tarefas retornadas de um descartável assíncrono são realizadas.

Confira também

• Documentos e dados XML