XmlWriter XmlWriter XmlWriter XmlWriter Class

Definição

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.Represents a writer that provides a fast, non-cached, forward-only way to generate streams or files that contain XML data.

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

Exemplos

O código de exemplo a seguir mostra como usar a API assíncrona para gerar XML.The following example code shows how to use the asynchronous API to generate 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

A XmlWriter classe grava dados XML em um fluxo, arquivo, leitor de texto ou cadeia de caracteres.The XmlWriter class writes XML data to a stream, file, text reader, or string. Ele dá suporte ao W3C linguagem XML (XML) 1,0 (quarta edição) e a namespaces nas recomendações de XML 1,0 (terceira edição) .It supports the W3C Extensible Markup Language (XML) 1.0 (fourth edition) and Namespaces in XML 1.0 (third edition) recommendations.

Os membros da XmlWriter classe permitem que você:The members of the XmlWriter class enable you to:

  • Verificar se os caracteres são caracteres XML legais e se os nomes de elementos e atributos são nomes XML válidos.Verify that the characters are legal XML characters and that element and attribute names are valid XML names.

  • Verificar se o documento XML é bem-formado.Verify that the XML document is well-formed.

  • Codifique os bytes binários como Base64 ou BinHex e escreva o texto resultante.Encode binary bytes as Base64 or BinHex, and write out the resulting text.

  • Passe valores usando Common Language Runtime tipos em vez de cadeias de caracteres, para evitar ter que executar conversões de valor manualmente.Pass values by using common language runtime types instead of strings, to avoid having to manually perform value conversions.

  • Gravar vários documentos em um fluxo de saída.Write multiple documents to one output stream.

  • Gravar nomes válidos, nomes qualificados e tokens de nomes.Write valid names, qualified names, and name tokens.

Nesta seção:In this section:

Criando um gravador de XML Creating an XML writer
Especificando o formato de saída Specifying the output format
Conformidade de dados Data conformance
Gravando elementos Writing elements
Gravando atributos Writing attributes
Manipulando namespaces Handling namespaces
Gravando dados digitados Writing typed data
Fechando o gravador de XML Closing the XML writer
Programação assíncrona Asynchronous programming
Considerações sobre segurançaSecurity considerations

Criando um gravador de XMLCreating an XML writer

Para criar uma XmlWriter instância, use o XmlWriter.Create método.To create an XmlWriter instance, use the XmlWriter.Create method. Para especificar o conjunto de recursos que você deseja habilitar no gravador de XML, passe um XmlWriterSettings para o Create método.To specify the set of features you want to enable on the XML writer, pass an XmlWriterSettings to the Create method. Caso contrário, as configurações padrão serão usadas.Otherwise, default settings are used. Consulte as Create páginas de referência para obter detalhes.See the Create reference pages for details.

Especificando o formato de saídaSpecifying the output format

A XmlWriterSettings classe inclui várias propriedades que controlam XmlWriter como a saída é formatada:The XmlWriterSettings class includes several properties that control how XmlWriter output is formatted:

PropriedadeProperty DescriçãoDescription
Encoding Especifica a codificação de texto para usar.Specifies the text encoding to use. O padrão é Encoding.UTF8.The default is Encoding.UTF8.
Indent Indica se recuar elementos.Indicates whether to indent elements. O padrão é false (sem recuo).The default is false (no indentation).
IndentChars Especifica a cadeia de caracteres para usar ao recuar.Specifies the character string to use when indenting. O padrão é os dois espaços.The default is two spaces.
NewLineChars Especifica a cadeia de caracteres para usar quebras de linha.Specifies the character string to use for line breaks. O padrão é \r\n (retorno de carro, alimentação de linha).The default is \r\n (carriage return, line feed).
NewLineHandling Especifica como lidar com caracteres de nova linha.Specifies how to handle newline characters.
NewLineOnAttributes Indica se escrever atributos em uma nova linha.Indicates whether to write attributes on a new line. Indent deve ser definido como true ao usar essa propriedade.Indent should be set to true when using this property. O padrão é false.The default is false.
OmitXmlDeclaration Indica se escrever uma declaração XML.Indicates whether to write an XML declaration. O padrão é false.The default is false.

As propriedades de Indent e de IndentChars controlam como o espaço em branco irrisória é formatado.The Indent and IndentChars properties control how insignificant white space is formatted. Por exemplo, para recuar nós de elemento:For example, to indent element nodes:

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = "\t";
XmlWriter writer = XmlWriter.Create("books.xml", settings);
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("books.xml", settings)

Use o NewLineOnAttributes para gravar cada atributo em uma nova linha com um nível extra de recuo:Use the NewLineOnAttributes to write each attribute on a new line with one extra level of indentation:

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.NewLineOnAttributes = true;
XmlWriter writer = XmlWriter.Create("books.xml", settings);
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.NewLineOnAttributes = True
Dim writer As XmlWriter = XmlWriter.Create("books.xml", settings)

Conformidade de dadosData conformance

Um gravador de XML usa duas propriedades da XmlWriterSettings classe para verificar a conformidade dos dados:An XML writer uses two properties from the XmlWriterSettings class to check for data conformance:

  • A CheckCharacters Propriedade instrui o gravador de XML a verificar os caracteres e lançar XmlException uma exceção se algum caractere estiver fora do intervalo legal, conforme definido pelo W3C.The CheckCharacters property instructs the XML writer to check characters and throw an XmlException exception if any characters are outside the legal range, as defined by the W3C.

  • A ConformanceLevel Propriedade configura o gravador de XML para verificar se o fluxo que está sendo gravado está em conformidade com as regras para um documento XML 1,0 bem formado ou fragmento de documento, conforme definido pelo W3C.The ConformanceLevel property configures the XML writer to check that the stream being written complies with the rules for a well-formed XML 1.0 document or document fragment, as defined by the W3C. Os três níveis de conformidade são descritos na tabela a seguir.The three conformance levels are described in the following table. O padrão é Document.The default is Document. Para obter detalhes, consulte XmlWriterSettings.ConformanceLevel a propriedade e System.Xml.ConformanceLevel a enumeração.For details, see the XmlWriterSettings.ConformanceLevel property and the System.Xml.ConformanceLevel enumeration.

    NívelLevel DescriçãoDescription
    Document A saída XML está em conformidade com as regras para um documento XML 1,0 bem formado e pode ser processada por qualquer processador compatível.The XML output conforms to the rules for a well-formed XML 1.0 document and can be processed by any conforming processor.
    Fragment A saída XML está em conformidade com as regras para um fragmento de documento XML 1,0 bem formado.The XML output conforms to the rules for a well-formed XML 1.0 document fragment.
    Auto O gravador de XML determina o nível de verificação de conformidade a ser aplicado (documento ou fragmento) com base nos dados de entrada.The XML writer determines which level of conformation checking to apply (document or fragment) based on the incoming data.

Gravando elementosWriting elements

Você pode usar os métodos XmlWriter a seguir para gravar nós de elementos.You can use the following XmlWriter methods to write element nodes. Para obter exemplos, consulte os métodos listados.For examples, see the methods listed.

UseUse ParaTo
WriteElementString Escreva um nó de elemento inteiro, incluindo um valor de cadeia de caracteres.Write an entire element node, including a string value.
WriteStartElement Para gravar um valor de elemento usando várias chamadas de método.To write an element value by using multiple method calls. Por exemplo, você pode chamar WriteValue para gravar um valor tipado, WriteCharEntity para gravar uma entidade de caracteres, WriteAttributeString para escrever um atributo, ou você pode escrever um elemento filho.For example, you can call WriteValue to write a typed value, WriteCharEntity to write a character entity, WriteAttributeString to write an attribute, or you can write a child element. Esta é uma versão mais sofisticada do WriteElementString método.This is a more sophisticated version of the WriteElementString method.

Para fechar o elemento, chame o WriteEndElement método ou. WriteFullEndElementTo close the element, you call the WriteEndElement or WriteFullEndElement method.
WriteNode Para copiar um nó de elemento encontrado na posição atual de um XmlReader objeto XPathNavigator ou.To copy an element node found at the current position of an XmlReader or XPathNavigator object. Quando chamado, copia todos do objeto de origem para a instância de XmlWriter .When called, it copies everything from the source object to the XmlWriter instance.

Gravando atributosWriting attributes

Você pode usar os métodos XmlWriter a seguir para gravar atributos em nós de elementos.You can use the following XmlWriter methods to write attributes on element nodes. Esses métodos também podem ser usados para criar declarações de namespace em um elemento, conforme discutido na próxima seção.These methods can also be used to create namespace declarations on an element, as discussed in the next section.

UseUse ParaTo
WriteAttributeString Para gravar um nó de atributo inteiro, incluindo um valor de cadeia de caracteres.To write an entire attribute node, including a string value.
WriteStartAttribute Para gravar o valor do atributo usando várias chamadas de método.To write the attribute value using multiple method calls. Por exemplo, você pode chamar WriteValue para gravar um valor tipado.For example, you can call WriteValue to write a typed value. Esta é uma versão mais sofisticada do WriteElementString método.This is a more sophisticated version of the WriteElementString method.

Para fechar o elemento, chame o WriteEndAttribute método.To close the element, you call the WriteEndAttribute method.
WriteAttributes Para copiar todos os atributos encontrados na posição atual de um XmlReader objeto.To copy all the attributes found at the current position of an XmlReader object. Os atributos que são gravados dependem do tipo de nó no qual o leitor está posicionado no momento:The attributes that are written depend on the type of node the reader is currently positioned on:

-Para um nó de atributo, ele grava o atributo atual e, em seguida, o restante dos atributos até a marca de fechamento do elemento.- For an attribute node, it writes the current attribute, and then the rest of the attributes until the element closing tag.
-Para um nó de elemento, ele grava todos os atributos contidos no elemento.- For an element node, it writes all attributes contained by the element.
-Para um nó de declaração XML, ele grava todos os atributos na declaração.- For an XML declaration node, it writes all the attributes in the declaration.
-Para todos os outros tipos de nó, o método gera uma exceção.- For all other node types, the method throws an exception.

Manipulando namespacesHandling namespaces

Namespaces são usados para qualificar nomes de elementos e atributos em um documento XML.Namespaces are used to qualify element and attribute names in an XML document. Os prefixos de namespace associam elementos e atributos a namespaces, que, por sua vez, estão associados a referências de URI.Namespace prefixes associate elements and attributes with namespaces, which are in turn associated with URI references. Namespaces criam a exclusividade de nome de elementos e atributos em um documento XML.Namespaces create element and attribute name uniqueness in an XML document.

O XmlWriter mantém uma pilha de namespace que corresponde a todos os namespaces definidos no escopo de namespace atual.The XmlWriter maintains a namespace stack that corresponds to all the namespaces defined in the current namespace scope. Ao escrever os elementos e atributos você pode utilizar namespaces das seguintes maneiras:When writing elements and attributes you can utilize namespaces in the following ways:

  • Declare os namespaces manualmente usando o WriteAttributeString método.Declare namespaces manually by using the WriteAttributeString method. Isso pode ser útil quando você souber a melhor otimizar o número de declarações de namespace.This can be useful when you know how to best optimize the number of namespace declarations. Para obter um exemplo, consulte WriteAttributeString(String, String, String, String) o método.For an example, see the WriteAttributeString(String, String, String, String) method.

  • Substitua a declaração atual do namespace com um novo namespace.Override the current namespace declaration with a new namespace. No código a seguir, o WriteAttributeString método altera o URI "x" de namespace do prefixo de "123" para "abc".In the following code, the WriteAttributeString method changes the namespace URI for the "x" prefix from "123" to "abc".

    writer.WriteStartElement("x", "root", "123");
    writer.WriteStartElement("item");
    writer.WriteAttributeString("xmlns", "x", null, "abc");
    writer.WriteEndElement();
    writer.WriteEndElement();
    
    writer.WriteStartElement("x", "root", "123")
    writer.WriteStartElement("item")
    writer.WriteAttributeString("xmlns", "x", Nothing, "abc")
    writer.WriteEndElement()
    writer.WriteEndElement()
    

    O código gerencia a seguinte cadeia de caracteres XML:The code generates the following XML string:

    <x:root xmlns:x="123">  
      <item xmlns:x="abc" />  
    </x:root>  
    
  • Especificar um prefixo de namespace para escrever atributos ou elementos.Specify a namespace prefix when writing attributes or elements. Muitos dos métodos usados para escrever elementos e atributos permitem que você faça isso.Many of the methods used to write element and attributes enable you to do this. Por exemplo, o WriteStartElement(String, String, String) método grava uma marca de início e a associa a um namespace e prefixo especificados.For example, the WriteStartElement(String, String, String) method writes a start tag and associates it with a specified namespace and prefix.

Gravando dados digitadosWriting typed data

O WriteValue método aceita um objeto Common Language Runtime (CLR), converte o valor de entrada em sua representação de cadeia de caracteres de acordo com as regras de conversão de tipo de dados XSD (linguagem de definição de WriteString esquema XML) e grava-o usando o método.The WriteValue method accepts a common language runtime (CLR) object, converts the input value to its string representation according to XML schema definition language (XSD) data type conversion rules, and writes it out by using the WriteString method. Isso é mais fácil do que usar os métodos XmlConvert na classe para converter os dados digitados em um valor de cadeia de caracteres antes de gravá-los.This is easier than using the methods in the XmlConvert class to convert the typed data to a string value before writing it out.

Ao gravar em texto, o valor digitado é serializado em texto usando as XmlConvert regras para esse tipo de esquema.When writing to text, the typed value is serialized to text by using the XmlConvert rules for that schema type.

Para tipos de dados XSD padrão que correspondem aos tipos CLR, consulte WriteValue o método.For default XSD data types that correspond to CLR types, see the WriteValue method.

O XmlWriter também pode ser usado para gravar em um repositório de dados XML.The XmlWriter can also be used to write to an XML data store. Por exemplo, a classe de XPathNavigator pode criar um objeto de XmlWriter para criar nós para um objeto de XmlDocument .For example, the XPathNavigator class can create an XmlWriter object to create nodes for an XmlDocument object. Se o armazenamento de dados tiver informações de esquema disponíveis para ele WriteValue , o método lançará uma exceção se você tentar converter em um tipo que não é permitido. Se o repositório de dados não tiver informações de esquema disponíveis para ele, WriteValue o método tratará todos os xsd:anySimpleType valores como um tipo.If the data store has schema information available to it, the WriteValue method throws an exception if you try to convert to a type that is not allowed.If the data store does not have schema information available to it, the WriteValue method treats all values as an xsd:anySimpleType type.

Fechando o gravador de XMLClosing the XML writer

Quando você usa XmlWriter métodos para gerar XML de saída, os elementos e atributos não são gravados até Close que você chame o método.When you use XmlWriter methods to output XML, the elements and attributes are not written until you call the Close method. Por exemplo, se você estiver usando XmlWriter o para popular XmlDocument um objeto, não poderá ver os elementos e atributos escritos no documento de destino até fechar a XmlWriter instância.For example, if you are using XmlWriter to populate an XmlDocument object, you won't be able to see the written elements and attributes in the target document until you close the XmlWriter instance.

Programação assíncronaAsynchronous programming

A maioria dos XmlWriter métodos tem contrapartes assíncronas que têm "Async" no final de seus nomes de método.Most of the XmlWriter methods have asynchronous counterparts that have "Async" at the end of their method names. Por exemplo, o equivalente assíncrono de WriteAttributeString é WriteAttributeStringAsync.For example, the asynchronous equivalent of WriteAttributeString is WriteAttributeStringAsync.

Para o WriteValue método, que não tem um equivalente assíncrono, converta o valor de retorno em uma cadeia de WriteStringAsync caracteres e use o método em vez disso.For the WriteValue method, which doesn't have an asynchronous counterpart, convert the return value to a string and use the WriteStringAsync method instead.

Considerações sobre segurançaSecurity considerations

Considere o seguinte ao trabalhar com a XmlWriter classe:Consider the following when working with the XmlWriter class:

  • As exceções geradas XmlWriter pelo podem divulgar informações de caminho que você não deseja que sejam compagadas ao aplicativo.Exceptions thrown by the XmlWriter can disclose path information that you do not want bubbled up to the app. Seu aplicativo deve capturar exceções e processá-las adequadamente.Your app must catch exceptions and process them appropriately.

  • XmlWriternão valida os dados que são passados para o WriteDocType método ou. WriteRawXmlWriter does not validate any data that is passed to the WriteDocType or WriteRaw method. Você não deve passar dados arbitrários para esses métodos.You should not pass arbitrary data to these methods.

Construtores

XmlWriter() XmlWriter() XmlWriter() XmlWriter()

Inicializa uma nova instância da classe XmlWriter.Initializes a new instance of the XmlWriter class.

Propriedades

Settings Settings Settings Settings

Obtém o objeto XmlWriterSettings usado para criar essa instância XmlWriter.Gets the XmlWriterSettings object used to create this XmlWriter instance.

WriteState WriteState WriteState WriteState

Quando substituído em uma classe derivada, obtém o estado do gravador.When overridden in a derived class, gets the state of the writer.

XmlLang XmlLang XmlLang XmlLang

Quando substituído em uma classe derivada, obtém o escopo xml:lang atual.When overridden in a derived class, gets the current xml:lang scope.

XmlSpace XmlSpace XmlSpace XmlSpace

Quando substituído em uma classe derivada, obtém um XmlSpace que representa o escopo xml:space atual.When overridden in a derived class, gets an XmlSpace representing the current xml:space scope.

Métodos

Close() Close() Close() Close()

Quando substituído em uma classe derivada, fecha este fluxo e o fluxo subjacente.When overridden in a derived class, closes this stream and the underlying stream.

Create(Stream) Create(Stream) Create(Stream) Create(Stream)

Cria uma nova instância de XmlWriter usando o fluxo especificado.Creates a new XmlWriter instance using the specified stream.

Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings) Create(Stream, XmlWriterSettings)

Cria uma nova instância do XmlWriter usando o fluxo e o objeto XmlWriterSettings.Creates a new XmlWriter instance using the stream and XmlWriterSettings object.

Create(String) Create(String) Create(String) Create(String)

Cria uma nova instância XmlWriter usando o nome de arquivo especificado.Creates a new XmlWriter instance using the specified filename.

Create(String, XmlWriterSettings) Create(String, XmlWriterSettings) Create(String, XmlWriterSettings) Create(String, XmlWriterSettings)

Cria uma nova XmlWriter instância usando o nome do arquivo e XmlWriterSettings objeto.Creates a new XmlWriter instance using the filename and XmlWriterSettings object.

Create(StringBuilder) Create(StringBuilder) Create(StringBuilder) Create(StringBuilder)

Cria uma nova instância XmlWriter usando o StringBuilder especificado.Creates a new XmlWriter instance using the specified StringBuilder.

Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings) Create(StringBuilder, XmlWriterSettings)

Cria uma nova instância do XmlWriter usando os objetos StringBuilder e XmlWriterSettings.Creates a new XmlWriter instance using the StringBuilder and XmlWriterSettings objects.

Create(TextWriter) Create(TextWriter) Create(TextWriter) Create(TextWriter)

Cria uma nova instância XmlWriter usando o TextWriter especificado.Creates a new XmlWriter instance using the specified TextWriter.

Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings) Create(TextWriter, XmlWriterSettings)

Cria uma nova instância do XmlWriter usando os objetos TextWriter e XmlWriterSettings.Creates a new XmlWriter instance using the TextWriter and XmlWriterSettings objects.

Create(XmlWriter) Create(XmlWriter) Create(XmlWriter) Create(XmlWriter)

Cria uma nova instância XmlWriter usando o objeto XmlWriter especificado.Creates a new XmlWriter instance using the specified XmlWriter object.

Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings) Create(XmlWriter, XmlWriterSettings)

Cria uma nova instância XmlWriter usando os objetos XmlWriter e XmlWriterSettings especificados.Creates a new XmlWriter instance using the specified XmlWriter and XmlWriterSettings objects.

Dispose() Dispose() Dispose() Dispose()

Libera todos os recursos usados pela instância atual da classe XmlWriter.Releases all resources used by the current instance of the XmlWriter class.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera os recursos não gerenciados usados pelo XmlWriter e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the XmlWriter and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Flush() Flush() Flush() 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.When overridden in a derived class, flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

FlushAsync() FlushAsync() FlushAsync() FlushAsync()

Libera de maneira assíncrona tudo o que está no buffer para os fluxos subjacentes e também libera o fluxo subjacente.Asynchronously flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
LookupPrefix(String) LookupPrefix(String) LookupPrefix(String) 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.When overridden in a derived class, returns the closest prefix defined in the current namespace scope for the namespace URI.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)
WriteAttributes(XmlReader, Boolean) WriteAttributes(XmlReader, Boolean) WriteAttributes(XmlReader, Boolean) WriteAttributes(XmlReader, Boolean)

Quando substituído em uma classe derivada, grava todos os atributos localizados na posição atual no XmlReader.When overridden in a derived class, writes out all the attributes found at the current position in the XmlReader.

WriteAttributesAsync(XmlReader, Boolean) WriteAttributesAsync(XmlReader, Boolean) WriteAttributesAsync(XmlReader, Boolean) WriteAttributesAsync(XmlReader, Boolean)

Grava de forma assíncrona todos os atributos encontrados na posição atual no XmlReader.Asynchronously writes out all the attributes found at the current position in the XmlReader.

WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String)

Quando substituído em uma classe derivada, grava o atributo com o nome local e o valor especificados.When overridden in a derived class, writes out the attribute with the specified local name and value.

WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) 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.When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.

WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) 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.When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteAttributeStringAsync(String, String, String, String) WriteAttributeStringAsync(String, String, String, String) WriteAttributeStringAsync(String, String, String, String) 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.Asynchronously writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32)

Quando substituído em uma classe derivada, codifica os bytes binários especificados como Base64 e grava o texto resultante.When overridden in a derived class, encodes the specified binary bytes as Base64 and writes out the resulting text.

WriteBase64Async(Byte[], Int32, Int32) WriteBase64Async(Byte[], Int32, Int32) WriteBase64Async(Byte[], Int32, Int32) WriteBase64Async(Byte[], Int32, Int32)

Codifica de forma assíncrona os bytes binários especificados como Base64 e grava o texto resultante.Asynchronously encodes the specified binary bytes as Base64 and writes out the resulting text.

WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32)

Quando substituído em uma classe derivada, codifica os bytes binários especificados como BinHex e grava o texto resultante.When overridden in a derived class, encodes the specified binary bytes as BinHex and writes out the resulting text.

WriteBinHexAsync(Byte[], Int32, Int32) WriteBinHexAsync(Byte[], Int32, Int32) WriteBinHexAsync(Byte[], Int32, Int32) WriteBinHexAsync(Byte[], Int32, Int32)

Codifica de forma assíncrona os bytes binários especificados como BinHex e grava o texto resultante.Asynchronously encodes the specified binary bytes as BinHex and writes out the resulting text.

WriteCData(String) WriteCData(String) WriteCData(String) WriteCData(String)

Quando substituído em uma classe derivada, grava um bloco <![CDATA[...]]> que contém o texto especificado.When overridden in a derived class, writes out a <![CDATA[...]]> block containing the specified text.

WriteCDataAsync(String) WriteCDataAsync(String) WriteCDataAsync(String) WriteCDataAsync(String)

Grava de forma assíncrona um bloco <![CDATA[...]]> que contém o texto especificado.Asynchronously writes out a <![CDATA[...]]> block containing the specified text.

WriteCharEntity(Char) WriteCharEntity(Char) WriteCharEntity(Char) 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.When overridden in a derived class, forces the generation of a character entity for the specified Unicode character value.

WriteCharEntityAsync(Char) WriteCharEntityAsync(Char) WriteCharEntityAsync(Char) WriteCharEntityAsync(Char)

Força de forma assíncrona a geração de uma entidade de caracteres para o valor de caractere Unicode especificado.Asynchronously forces the generation of a character entity for the specified Unicode character value.

WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32)

Quando substituído em uma classe derivada, grava texto um buffer por vez.When overridden in a derived class, writes text one buffer at a time.

WriteCharsAsync(Char[], Int32, Int32) WriteCharsAsync(Char[], Int32, Int32) WriteCharsAsync(Char[], Int32, Int32) WriteCharsAsync(Char[], Int32, Int32)

Grava texto de forma assíncrona um buffer por vez.Asynchronously writes text one buffer at a time.

WriteComment(String) WriteComment(String) WriteComment(String) WriteComment(String)

Quando substituído em uma classe derivada, grava um comentário <!--...--> que contém o texto especificado.When overridden in a derived class, writes out a comment <!--...--> containing the specified text.

WriteCommentAsync(String) WriteCommentAsync(String) WriteCommentAsync(String) WriteCommentAsync(String)

Grava de forma assíncrona um comentário <!--...--> que contém o texto especificado.Asynchronously writes out a comment <!--...--> containing the specified text.

WriteDocType(String, String, String, String) WriteDocType(String, String, String, String) WriteDocType(String, String, String, String) 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.When overridden in a derived class, writes the DOCTYPE declaration with the specified name and optional attributes.

WriteDocTypeAsync(String, String, String, String) WriteDocTypeAsync(String, String, String, String) WriteDocTypeAsync(String, String, String, String) WriteDocTypeAsync(String, String, String, String)

Grava de forma assíncrona a declaração DOCTYPE com o nome especificado e os atributos opcionais.Asynchronously writes the DOCTYPE declaration with the specified name and optional attributes.

WriteElementString(String, String) WriteElementString(String, String) WriteElementString(String, String) WriteElementString(String, String)

Grava um elemento com o valor e o nome local especificados.Writes an element with the specified local name and value.

WriteElementString(String, String, String) WriteElementString(String, String, String) WriteElementString(String, String, String) WriteElementString(String, String, String)

Grava um elemento com o nome local, URI de namespace e valor especificados.Writes an element with the specified local name, namespace URI, and value.

WriteElementString(String, String, String, String) WriteElementString(String, String, String, String) WriteElementString(String, String, String, String) WriteElementString(String, String, String, String)

Grava um elemento com o prefixo, o nome local, o URI do namespace e o valor especificados.Writes an element with the specified prefix, local name, namespace URI, and value.

WriteElementStringAsync(String, String, String, String) WriteElementStringAsync(String, String, String, String) WriteElementStringAsync(String, String, String, String) 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.Asynchronously writes an element with the specified prefix, local name, namespace URI, and value.

WriteEndAttribute() WriteEndAttribute() WriteEndAttribute() WriteEndAttribute()

Quando substituído em uma classe derivada, fecha a chamada WriteStartAttribute(String, String) anterior.When overridden in a derived class, closes the previous WriteStartAttribute(String, String) call.

WriteEndAttributeAsync() WriteEndAttributeAsync() WriteEndAttributeAsync() WriteEndAttributeAsync()

Fecha de forma assíncrona a chamada WriteStartAttribute(String, String) anterior.Asynchronously closes the previous WriteStartAttribute(String, String) call.

WriteEndDocument() WriteEndDocument() WriteEndDocument() WriteEndDocument()

Quando substituído em uma classe derivada, fecha todos os elementos ou atributos abertos e coloca o gravador de volta no estado Inicial.When overridden in a derived class, closes any open elements or attributes and puts the writer back in the Start state.

WriteEndDocumentAsync() WriteEndDocumentAsync() WriteEndDocumentAsync() WriteEndDocumentAsync()

Fecha de forma assíncrona os elementos ou atributos abertos e coloca o gravador de volta no estado Inicial.Asynchronously closes any open elements or attributes and puts the writer back in the Start state.

WriteEndElement() WriteEndElement() WriteEndElement() WriteEndElement()

Quando substituído em uma classe derivada, fecha um elemento e aciona o escopo de namespace correspondente.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

WriteEndElementAsync() WriteEndElementAsync() WriteEndElementAsync() WriteEndElementAsync()

Fecha de forma assíncrona um elemento e remove o escopo de namespace correspondente da pilha.Asynchronously closes one element and pops the corresponding namespace scope.

WriteEntityRef(String) WriteEntityRef(String) WriteEntityRef(String) WriteEntityRef(String)

Quando substituído em uma classe derivada, grava uma referência de entidade como &name;.When overridden in a derived class, writes out an entity reference as &name;.

WriteEntityRefAsync(String) WriteEntityRefAsync(String) WriteEntityRefAsync(String) WriteEntityRefAsync(String)

Grava de forma assíncrona uma referência de entidade como &name;.Asynchronously writes out an entity reference as &name;.

WriteFullEndElement() WriteFullEndElement() WriteFullEndElement() WriteFullEndElement()

Quando substituído em uma classe derivada, fecha um elemento e aciona o escopo de namespace correspondente.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

WriteFullEndElementAsync() WriteFullEndElementAsync() WriteFullEndElementAsync() WriteFullEndElementAsync()

Fecha de forma assíncrona um elemento e remove o escopo de namespace correspondente da pilha.Asynchronously closes one element and pops the corresponding namespace scope.

WriteName(String) WriteName(String) WriteName(String) 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).When overridden in a derived class, writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNameAsync(String) WriteNameAsync(String) WriteNameAsync(String) WriteNameAsync(String)

Grava de maneira 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).Asynchronously writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNmToken(String) WriteNmToken(String) WriteNmToken(String) 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).When overridden in a derived class, writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNmTokenAsync(String) WriteNmTokenAsync(String) WriteNmTokenAsync(String) WriteNmTokenAsync(String)

Grava de maneira 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).Asynchronously writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNode(XmlReader, Boolean) WriteNode(XmlReader, Boolean) WriteNode(XmlReader, Boolean) 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.When overridden in a derived class, copies everything from the reader to the writer and moves the reader to the start of the next sibling.

WriteNode(XPathNavigator, Boolean) WriteNode(XPathNavigator, Boolean) WriteNode(XPathNavigator, Boolean) WriteNode(XPathNavigator, Boolean)

Copia tudo do objeto XPathNavigator no gravador.Copies everything from the XPathNavigator object to the writer. A posição do XPathNavigator permanece inalterada.The position of the XPathNavigator remains unchanged.

WriteNodeAsync(XmlReader, Boolean) WriteNodeAsync(XmlReader, Boolean) WriteNodeAsync(XmlReader, Boolean) 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.Asynchronously copies everything from the reader to the writer and moves the reader to the start of the next sibling.

WriteNodeAsync(XPathNavigator, Boolean) WriteNodeAsync(XPathNavigator, Boolean) WriteNodeAsync(XPathNavigator, Boolean) WriteNodeAsync(XPathNavigator, Boolean)

Copia de forma assíncrona tudo do objeto XPathNavigator para o gravador.Asynchronously copies everything from the XPathNavigator object to the writer. A posição do XPathNavigator permanece inalterada.The position of the XPathNavigator remains unchanged.

WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String) 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?>.When overridden in a derived class, writes out a processing instruction with a space between the name and text as follows: <?name text?>.

WriteProcessingInstructionAsync(String, String) WriteProcessingInstructionAsync(String, String) WriteProcessingInstructionAsync(String, String) 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?>.Asynchronously writes out a processing instruction with a space between the name and text as follows: <?name text?>.

WriteQualifiedName(String, String) WriteQualifiedName(String, String) WriteQualifiedName(String, String) WriteQualifiedName(String, String)

Quando substituído em uma classe derivada, grava o nome qualificado do namespace.When overridden in a derived class, writes out the namespace-qualified name. Este método pesquisa o prefixo que está no escopo para o namespace fornecido.This method looks up the prefix that is in scope for the given namespace.

WriteQualifiedNameAsync(String, String) WriteQualifiedNameAsync(String, String) WriteQualifiedNameAsync(String, String) WriteQualifiedNameAsync(String, String)

Grava de forma assíncrona o nome qualificado do namespace.Asynchronously writes out the namespace-qualified name. Este método pesquisa o prefixo que está no escopo para o namespace fornecido.This method looks up the prefix that is in scope for the given namespace.

WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32)

Quando substituído em uma classe derivada, grava a marcação bruta manualmente de um buffer de caracteres.When overridden in a derived class, writes raw markup manually from a character buffer.

WriteRaw(String) WriteRaw(String) WriteRaw(String) WriteRaw(String)

Quando substituído em uma classe derivada, grava manualmente a marcação bruta de uma cadeia de caracteres.When overridden in a derived class, writes raw markup manually from a string.

WriteRawAsync(Char[], Int32, Int32) WriteRawAsync(Char[], Int32, Int32) WriteRawAsync(Char[], Int32, Int32) WriteRawAsync(Char[], Int32, Int32)

Grava de forma assíncrona e manual a marcação bruta de um buffer de caracteres.Asynchronously writes raw markup manually from a character buffer.

WriteRawAsync(String) WriteRawAsync(String) WriteRawAsync(String) WriteRawAsync(String)

Grava de forma assíncrona e manual a marcação bruta de uma cadeia de caracteres.Asynchronously writes raw markup manually from a string.

WriteStartAttribute(String) WriteStartAttribute(String) WriteStartAttribute(String) WriteStartAttribute(String)

Grava o início de um atributo com o nome do local especificado.Writes the start of an attribute with the specified local name.

WriteStartAttribute(String, String) WriteStartAttribute(String, String) WriteStartAttribute(String, String) WriteStartAttribute(String, String)

Grava o início de um atributo com o nome do local e o URI de namespace especificados.Writes the start of an attribute with the specified local name and namespace URI.

WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) 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.When overridden in a derived class, writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartAttributeAsync(String, String, String) WriteStartAttributeAsync(String, String, String) WriteStartAttributeAsync(String, String, String) 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.Asynchronously writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartDocument() WriteStartDocument() WriteStartDocument() WriteStartDocument()

Quando substituído em uma classe derivada, grava a declaração XML com a versão "1.0".When overridden in a derived class, writes the XML declaration with the version "1.0".

WriteStartDocument(Boolean) WriteStartDocument(Boolean) WriteStartDocument(Boolean) 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.When overridden in a derived class, writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartDocumentAsync() WriteStartDocumentAsync() WriteStartDocumentAsync() WriteStartDocumentAsync()

Grava de forma assíncrona a declaração XML com a versão “1.0”.Asynchronously writes the XML declaration with the version "1.0".

WriteStartDocumentAsync(Boolean) WriteStartDocumentAsync(Boolean) WriteStartDocumentAsync(Boolean) WriteStartDocumentAsync(Boolean)

Grava de forma assíncrona a declaração XML com a versão “1.0” e o atributo autônomo.Asynchronously writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartElement(String) WriteStartElement(String) WriteStartElement(String) WriteStartElement(String)

Quando substituído em uma classe derivada, grava uma marca de início com o nome local especificado.When overridden in a derived class, writes out a start tag with the specified local name.

WriteStartElement(String, String) WriteStartElement(String, String) WriteStartElement(String, String) WriteStartElement(String, String)

Quando substituído em uma classe derivada, grava a marca de início especificada e a associa ao namespace específico.When overridden in a derived class, writes the specified start tag and associates it with the given namespace.

WriteStartElement(String, String, String) WriteStartElement(String, String, String) WriteStartElement(String, String, String) 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.When overridden in a derived class, writes the specified start tag and associates it with the given namespace and prefix.

WriteStartElementAsync(String, String, String) WriteStartElementAsync(String, String, String) WriteStartElementAsync(String, String, String) WriteStartElementAsync(String, String, String)

Grava de forma assíncrona a marca de início especificada e a associa ao namespace e ao prefixo fornecidos.Asynchronously writes the specified start tag and associates it with the given namespace and prefix.

WriteString(String) WriteString(String) WriteString(String) WriteString(String)

Quando substituído em uma classe derivada, grava o conteúdo de texto especificado.When overridden in a derived class, writes the given text content.

WriteStringAsync(String) WriteStringAsync(String) WriteStringAsync(String) WriteStringAsync(String)

Grava de forma assíncrona o conteúdo de texto fornecido.Asynchronously writes the given text content.

WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char)

Quando substituído em uma classe derivada, gera e grava a entidade de caracteres alternativos para o par de caracteres alternativos.When overridden in a derived class, generates and writes the surrogate character entity for the surrogate character pair.

WriteSurrogateCharEntityAsync(Char, Char) WriteSurrogateCharEntityAsync(Char, Char) WriteSurrogateCharEntityAsync(Char, Char) WriteSurrogateCharEntityAsync(Char, Char)

Gera e grava a entidade de caracteres alternativos de forma assíncrona para o par de caracteres alternativos.Asynchronously generates and writes the surrogate character entity for the surrogate character pair.

WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean)

Grava um valor Boolean.Writes a Boolean value.

WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime)

Grava um valor DateTime.Writes a DateTime value.

WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset)

Grava um valor DateTimeOffset.Writes a DateTimeOffset value.

WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal)

Grava um valor Decimal.Writes a Decimal value.

WriteValue(Double) WriteValue(Double) WriteValue(Double) WriteValue(Double)

Grava um valor Double.Writes a Double value.

WriteValue(Int32) WriteValue(Int32) WriteValue(Int32) WriteValue(Int32)

Grava um valor Int32.Writes a Int32 value.

WriteValue(Int64) WriteValue(Int64) WriteValue(Int64) WriteValue(Int64)

Grava um valor Int64.Writes a Int64 value.

WriteValue(Object) WriteValue(Object) WriteValue(Object) WriteValue(Object)

Grava o valor do objeto.Writes the object value.

WriteValue(Single) WriteValue(Single) WriteValue(Single) WriteValue(Single)

Grava um número de ponto flutuante de precisão simples.Writes a single-precision floating-point number.

WriteValue(String) WriteValue(String) WriteValue(String) WriteValue(String)

Grava um valor String.Writes a String value.

WriteWhitespace(String) WriteWhitespace(String) WriteWhitespace(String) WriteWhitespace(String)

Quando substituído em uma classe derivada, grava o espaço em branco determinado.When overridden in a derived class, writes out the given white space.

WriteWhitespaceAsync(String) WriteWhitespaceAsync(String) WriteWhitespaceAsync(String) WriteWhitespaceAsync(String)

Grava de forma assíncrona o espaço em branco determinado.Asynchronously writes out the given white space.

Implantações explícitas de interface

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

Para obter uma descrição desse membro, consulte Dispose().For a description of this member, see Dispose().

Aplica-se a

Veja também