XmlWriter Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 : IDisposable
public ref class XmlWriter abstract : IAsyncDisposable, IDisposable
public ref class XmlWriter abstract
public abstract class XmlWriter : IDisposable
public abstract class XmlWriter : IAsyncDisposable, IDisposable
public abstract class XmlWriter
type XmlWriter = class
interface IDisposable
type XmlWriter = class
interface IAsyncDisposable
interface IDisposable
type XmlWriter = class
Public MustInherit Class XmlWriter
Implements IDisposable
Public MustInherit Class XmlWriter
Implements IAsyncDisposable, IDisposable
Public MustInherit Class XmlWriter
- Herança
-
XmlWriter
- Derivado
- Implementações
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 |
XmlSpace |
Quando substituído em uma classe derivada, obtém um XmlSpace que representa o escopo |
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 |
WriteBinHexAsync(Byte[], Int32, Int32) |
Codifica de forma assíncrona os bytes binários especificados como |
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 |
WriteEntityRefAsync(String) |
Grava de forma assíncrona uma referência de entidade como |
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. |
Implantações explícitas de interface
IDisposable.Dispose() |
Para obter uma descrição desse membro, confira Dispose(). |
Métodos de Extensão
ConfigureAwait(IAsyncDisposable, Boolean) |
Configura como as esperas nas tarefas retornadas de um descartável assíncrono são realizadas. |
Aplica-se a
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários