XmlWriter Classe

Definição

Namespace:
System.Xml
Assemblies:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
netstandard.dll

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

public ref class XmlWriter abstract : IDisposable
public ref class XmlWriter abstract
public abstract class XmlWriter : IDisposable
public abstract class XmlWriter
type XmlWriter = class
    interface IDisposable
type XmlWriter = class
Public MustInherit Class XmlWriter
Implements IDisposable
Public MustInherit Class XmlWriter
Herança
Object
XmlWriter
Derivado
Implementações
IDisposable

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 Suplementar para XmlWriter.

Construtores

Nome Description
XmlWriter()

Inicializa uma nova instância da classe XmlWriter.

Propriedades

Nome Description
Settings

Obtém o XmlWriterSettings objeto usado para criar essa XmlWriter instância.
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 atual xml:lang .
XmlSpace

Quando substituído em uma classe derivada, obtém um XmlSpace que representa o escopo atual xml:space .

Métodos

Nome Description
Close()

Quando substituído em uma classe derivada, fecha esse fluxo e o fluxo subjacente.
Create(Stream, XmlWriterSettings)

Cria uma nova XmlWriter instância usando o fluxo e XmlWriterSettings o objeto.
Create(Stream)

Cria uma nova XmlWriter instância usando o fluxo especificado.
Create(String, XmlWriterSettings)

Cria uma nova XmlWriter instância usando o nome do arquivo e XmlWriterSettings o objeto.
Create(String)

Cria uma nova XmlWriter instância usando o nome de arquivo especificado.
Create(StringBuilder, XmlWriterSettings)

Cria uma nova XmlWriter instância usando os objetos eXmlWriterSettings.StringBuilder
Create(StringBuilder)

Cria uma nova XmlWriter instância usando a especificada StringBuilder.
Create(TextWriter, XmlWriterSettings)

Cria uma nova XmlWriter instância usando os objetos eXmlWriterSettings.TextWriter
Create(TextWriter)

Cria uma nova XmlWriter instância usando a especificada TextWriter.
Create(XmlWriter, XmlWriterSettings)

Cria uma nova XmlWriter instância usando os objetos e XmlWriterSettings especificadosXmlWriter.
Create(XmlWriter)

Cria uma nova XmlWriter instância usando o objeto especificado XmlWriter .
Dispose()

Libera todos os recursos usados pela instância atual da XmlWriter classe.
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo XmlWriter e, opcionalmente, libera os recursos gerenciados.
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 forma assíncrona o que estiver no buffer para os fluxos subjacentes e também libera o fluxo subjacente.
GetHashCode()

Serve como a função hash predefinida.

(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 do namespace.
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

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

Quando substituído em uma classe derivada, grava o atributo com o prefixo, o nome local, o URI do namespace e o valor especificados.
WriteAttributeString(String, String, String)

Quando substituído em uma classe derivada, grava um atributo com o nome local, o URI do namespace e o valor especificados.
WriteAttributeString(String, String)

Quando substituído em uma classe derivada, grava o atributo com o nome e o valor locais especificados.
WriteAttributeStringAsync(String, String, String, String)

Grava de forma assíncrona o atributo com o prefixo, o nome local, o URI do namespace e o valor especificados.
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 BinHex binários especificados e grava o texto resultante.
WriteCData(String)

Quando substituído em uma classe derivada, grava um <![ CDATA[...]]> bloco que contém o texto especificado.
WriteCDataAsync(String)

Grava de forma assíncrona um <![ CDATA[...]]> bloco que contém o texto especificado.
WriteCharEntity(Char)

Quando substituído em uma classe derivada, força a geração de uma entidade de caractere para o valor de caractere Unicode especificado.
WriteCharEntityAsync(Char)

Força de forma assíncrona a geração de uma entidade de caractere para o valor de caractere Unicode especificado.
WriteChars(Char[], Int32, Int32)

Quando substituído em uma classe derivada, grava um buffer de texto por vez.
WriteCharsAsync(Char[], Int32, Int32)

Grava de forma assíncrona o texto um buffer de cada 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 atributos opcionais.
WriteDocTypeAsync(String, String, String, String)

Grava de forma assíncrona a declaração DOCTYPE com o nome especificado e atributos opcionais.
WriteElementString(String, String, String, String)

Grava um elemento com o prefixo, o nome local, o URI do namespace e o valor especificados.
WriteElementString(String, String, String)

Grava um elemento com o nome local, o URI do namespace e o valor especificados.
WriteElementString(String, String)

Grava um elemento com o nome e o valor locais especificados.
WriteElementStringAsync(String, String, String, String)

Grava de forma assíncrona um elemento com o prefixo, o nome local, o URI do namespace e o valor especificados.
WriteEndAttribute()

Quando substituído em uma classe derivada, fecha a chamada anterior WriteStartAttribute(String, String) .
WriteEndAttributeAsync()

Fecha assíncronamente a chamada anterior WriteStartAttribute(String, String) .
WriteEndDocument()

Quando substituído em uma classe derivada, fecha todos os elementos ou atributos abertos e coloca o gravador de volta no estado Iniciar.
WriteEndDocumentAsync()

Fecha de forma assíncrona todos os elementos ou atributos abertos e coloca o gravador de volta no estado Iniciar.
WriteEndElement()

Quando substituído em uma classe derivada, fecha um elemento e exibe o escopo do namespace correspondente.
WriteEndElementAsync()

Fecha de forma assíncrona um elemento e exibe o escopo do namespace correspondente.
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 exibe o escopo do namespace correspondente.
WriteFullEndElementAsync()

Fecha de forma assíncrona um elemento e exibe o escopo do namespace correspondente.
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 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 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 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 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 para o gravador e move o leitor para o início do próximo irmão.
WriteNode(XPathNavigator, Boolean)

Copia tudo do XPathNavigator objeto para o gravador. A posição dos XPathNavigator restos mortais permanece inalterada.
WriteNodeAsync(XmlReader, Boolean)

Copia de forma assíncrona tudo, desde o leitor até o gravador e move o leitor para o início do próximo irmão.
WriteNodeAsync(XPathNavigator, Boolean)

Copia de forma assíncrona tudo, desde o XPathNavigator objeto até o gravador. A posição dos XPathNavigator restos mortais 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: <?name text?>.
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: <?name text?>.
WriteQualifiedName(String, String)

Quando substituído em uma classe derivada, grava o nome qualificado do namespace. Esse método procura o prefixo que está no escopo do namespace fornecido.
WriteQualifiedNameAsync(String, String)

Grava de forma assíncrona o nome qualificado do namespace. Esse método procura o prefixo que está no escopo do 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 a marcação bruta manualmente de uma cadeia de caracteres.
WriteRawAsync(Char[], Int32, Int32)

Grava manualmente a marcação bruta de forma assíncrona de um buffer de caracteres.
WriteRawAsync(String)

Grava a marcação bruta manualmente de uma cadeia de caracteres de forma assíncrona.
WriteStartAttribute(String, String, String)

Quando substituído em uma classe derivada, grava o início de um atributo com o prefixo, o nome local e o URI do namespace especificados.
WriteStartAttribute(String, String)

Grava o início de um atributo com o nome local especificado e o URI do namespace.
WriteStartAttribute(String)

Grava o início de um atributo com o nome local especificado.
WriteStartAttributeAsync(String, String, String)

Grava de forma assíncrona o início de um atributo com o prefixo, o nome local e o URI do 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, String, String)

Quando substituído em uma classe derivada, grava a marca inicial especificada e a associa ao namespace e ao prefixo fornecidos.
WriteStartElement(String, String)

Quando substituído em uma classe derivada, grava a marca inicial especificada e a associa ao namespace fornecido.
WriteStartElement(String)

Quando substituído em uma classe derivada, grava uma marca inicial com o nome local especificado.
WriteStartElementAsync(String, String, String)

Grava de forma assíncrona a marca inicial especificada e a associa ao namespace e ao prefixo fornecidos.
WriteString(String)

Quando substituído numa classe derivada, escreve o conteúdo de texto especificado.
WriteStringAsync(String)

Grava de forma assíncrona o conteúdo de texto especificado.
WriteSurrogateCharEntity(Char, Char)

Quando substituído em uma classe derivada, gera e grava a entidade de caractere substituto para o par de caracteres alternativos.
WriteSurrogateCharEntityAsync(Char, Char)

Gera e grava de forma assíncrona a entidade de caractere substituto para o par de caracteres substituto.
WriteValue(Boolean)

Grava um Boolean valor.
WriteValue(DateTime)

Grava um DateTime valor.
WriteValue(DateTimeOffset)

Grava um DateTimeOffset valor.
WriteValue(Decimal)

Grava um Decimal valor.
WriteValue(Double)

Grava um Double valor.
WriteValue(Int32)

Grava um Int32 valor.
WriteValue(Int64)

Grava um Int64 valor.
WriteValue(Object)

Grava o valor do objeto.
WriteValue(Single)

Grava um número de ponto flutuante de precisão única.
WriteValue(String)

Grava um String valor.
WriteWhitespace(String)

Quando substituído em uma classe derivada, grava o espaço em branco especificado.
WriteWhitespaceAsync(String)

Grava de forma assíncrona o espaço em branco determinado.

Implantações explícitas de interface

Nome Description
IDisposable.Dispose()

Para obter uma descrição deste membro, consulte Dispose().

Aplica-se a

Confira também