XmlWriter XmlWriter XmlWriter XmlWriter Class

Definición

Representa un sistema de escritura que constituye una manera rápida, no almacenada en caché y de solo avance para generar flujos o archivos que contienen datos 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
Herencia
XmlWriterXmlWriterXmlWriterXmlWriter
Derivado
Implementaciones

Ejemplos

Ejemplo de código siguiente muestra cómo usar la API asincrónica para generar 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();  
    }  
}  

Comentarios

La XmlWriter clase escribe datos XML en una secuencia, archivo, lector de texto o cadena.The XmlWriter class writes XML data to a stream, file, text reader, or string. Es compatible con el W3C Extensible Markup Language (XML) 1.0 (fourth edition) y espacios de nombres en XML 1.0 (tercera edición) recomendaciones.It supports the W3C Extensible Markup Language (XML) 1.0 (fourth edition) and Namespaces in XML 1.0 (third edition) recommendations.

Los miembros de la XmlWriter clase le permiten:The members of the XmlWriter class enable you to:

  • Comprobar que los caracteres son caracteres legales XML y que los nombres de elemento y atributo son nombres XML válidos.Verify that the characters are legal XML characters and that element and attribute names are valid XML names.

  • Comprobar que el documento XML tiene el formato correcto.Verify that the XML document is well-formed.

  • Codificar bytes binarios Base64 y BinHex y escribir el texto resultante.Encode binary bytes as Base64 or BinHex, and write out the resulting text.

  • Pasar valores utilizando tipos common language runtime en lugar de cadenas, para evitar tener que realizar manualmente conversiones de valores.Pass values by using common language runtime types instead of strings, to avoid having to manually perform value conversions.

  • Escribir varios documentos en un flujo de salida.Write multiple documents to one output stream.

  • Escribir nombres válidos, nombres completos y tokens de nombres.Write valid names, qualified names, and name tokens.

En esta sección:In this section:

Creación de un sistema de escritura XML Creating an XML writer
Especifica el formato de salida Specifying the output format
Cumplimiento en datos Data conformance
Escritura de elementos Writing elements
Escribir atributos Writing attributes
Controlar espacios de nombres Handling namespaces
Escribir datos de tipo Writing typed data
El escritor XML de cierre Closing the XML writer
Programación asincrónica Asynchronous programming
Consideraciones de seguridadSecurity considerations

Creación de un sistema de escritura XMLCreating an XML writer

Para crear un XmlWriter de la instancia, utilice el XmlWriter.Create método.To create an XmlWriter instance, use the XmlWriter.Create method. Para especificar el conjunto de características que desea habilitar en el sistema de escritura XML, pase un XmlWriterSettings a la Create método.To specify the set of features you want to enable on the XML writer, pass an XmlWriterSettings to the Create method. En caso contrario, se utiliza la configuración predeterminada.Otherwise, default settings are used. Consulte la Create páginas para obtener más información de referencia.See the Create reference pages for details.

Especifica el formato de salidaSpecifying the output format

El XmlWriterSettings clase incluye varias propiedades que controlan cómo XmlWriter se formatea la salida:The XmlWriterSettings class includes several properties that control how XmlWriter output is formatted:

Propiedad.Property DescripciónDescription
Encoding Especifica la codificación de texto que se va a utilizar.Specifies the text encoding to use. De manera predeterminada, es Encoding.UTF8.The default is Encoding.UTF8.
Indent Indica si se van a aplicar sangrías a los elementos. Indicates whether to indent elements. El valor predeterminado es false (ninguna sangría).The default is false (no indentation).
IndentChars Especifica la cadena de caracteres que se va a utilizar para aplicar la sangría.Specifies the character string to use when indenting. El valor predeterminado es dos espacios.The default is two spaces.
NewLineChars Especifica la cadena de caracteres que se va a utilizar para los saltos de línea.Specifies the character string to use for line breaks. El valor predeterminado es \r\n (retorno de carro, avance de línea).The default is \r\n (carriage return, line feed).
NewLineHandling Especifica cómo tratar los caracteres de nueva línea.Specifies how to handle newline characters.
NewLineOnAttributes Indica si se van a escribir atributos en una línea nueva.Indicates whether to write attributes on a new line. Indent se debería establecer en true si se utiliza esta propiedad.Indent should be set to true when using this property. De manera predeterminada, es false.The default is false.
OmitXmlDeclaration Indica si se va a escribir una declaración XML.Indicates whether to write an XML declaration. De manera predeterminada, es false.The default is false.

Las propiedades Indent y IndentChars controlan cómo se da formato al espacio en blanco que es poco importante.The Indent and IndentChars properties control how insignificant white space is formatted. Por ejemplo, para aplicar sangría a los nodos 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 el NewLineOnAttributes para escribir cada atributo en una nueva línea con un nivel adicional de sangría: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)

Cumplimiento en datosData conformance

Un sistema de escritura XML usa dos propiedades de la XmlWriterSettings clase para comprobar el cumplimiento de datos:An XML writer uses two properties from the XmlWriterSettings class to check for data conformance:

  • El CheckCharacters propiedad indica al escritor XML que compruebe los caracteres e inicie una XmlException excepción si los caracteres están fuera del rango permitido, tal como se define por el 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.

  • El ConformanceLevel propiedad configura el escritor XML para comprobar que la secuencia que se está escribiendo cumple con las reglas para un documento XML 1.0 correcto o un fragmento de documento, tal como se define por el 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. Se describen los tres niveles en la tabla siguiente.The three conformance levels are described in the following table. De manera predeterminada, es Document.The default is Document. Para obtener más información, consulte el XmlWriterSettings.ConformanceLevel propiedad y el System.Xml.ConformanceLevel enumeración.For details, see the XmlWriterSettings.ConformanceLevel property and the System.Xml.ConformanceLevel enumeration.

    NivelLevel DescripciónDescription
    Document La salida XML se ajusta a las reglas de un documento XML 1.0 correcto y puede ser procesada por cualquier procesador compatible.The XML output conforms to the rules for a well-formed XML 1.0 document and can be processed by any conforming processor.
    Fragment La salida XML se ajusta a las reglas para un fragmento de documento XML 1.0 correcto.The XML output conforms to the rules for a well-formed XML 1.0 document fragment.
    Auto El escritor XML determina qué nivel de conformación para aplicar la comprobación (documento o fragmento) en función de los datos entrantes.The XML writer determines which level of conformation checking to apply (document or fragment) based on the incoming data.

Escritura de elementosWriting elements

Puede utilizar la siguiente XmlWriter métodos para escribir nodos de elemento.You can use the following XmlWriter methods to write element nodes. Para obtener ejemplos, vea los métodos enumerados.For examples, see the methods listed.

UsarUse EnTo
WriteElementString Escribir un nodo de elementos completo, incluyendo un valor de cadena.Write an entire element node, including a string value.
WriteStartElement Para escribir un valor del elemento utilizando varias llamadas a métodos.To write an element value by using multiple method calls. Por ejemplo, puede llamar a WriteValue para escribir un valor con establecimiento de tipos, a WriteCharEntity para escribir una entidad de caracteres, a WriteAttributeString para escribir un atributo o puede escribir un elemento secundario.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. Se trata de una versión más sofisticada de los WriteElementString método.This is a more sophisticated version of the WriteElementString method.

Para cerrar el elemento, llame a la WriteEndElement o WriteFullEndElement método.To close the element, you call the WriteEndElement or WriteFullEndElement method.
WriteNode Para copiar un nodo de elemento se encuentra en la posición actual de un XmlReader o XPathNavigator objeto.To copy an element node found at the current position of an XmlReader or XPathNavigator object. Cuando se llama, copia todo del objeto de origen en la instancia de XmlWriter.When called, it copies everything from the source object to the XmlWriter instance.

Escribir atributosWriting attributes

Puede utilizar la siguiente XmlWriter métodos para escribir atributos en nodos de elemento.You can use the following XmlWriter methods to write attributes on element nodes. Estos métodos también pueden utilizarse para crear las declaraciones de espacio de nombres en un elemento, como se describe en la sección siguiente.These methods can also be used to create namespace declarations on an element, as discussed in the next section.

UsarUse EnTo
WriteAttributeString Para escribir un nodo de atributos completo, incluyendo un valor de cadena.To write an entire attribute node, including a string value.
WriteStartAttribute Para escribir el valor del atributo utilizando varias llamadas de método.To write the attribute value using multiple method calls. Por ejemplo, puede llamar a WriteValue para escribir un valor con tipo.For example, you can call WriteValue to write a typed value. Se trata de una versión más sofisticada de los WriteElementString método.This is a more sophisticated version of the WriteElementString method.

Para cerrar el elemento, llame a la WriteEndAttribute método.To close the element, you call the WriteEndAttribute method.
WriteAttributes Para copiar todos los atributos encontrados en la posición actual de un XmlReader objeto.To copy all the attributes found at the current position of an XmlReader object. Los atributos que se escriben dependen del tipo de nodo que está situado actualmente el lector:The attributes that are written depend on the type of node the reader is currently positioned on:

-Para un nodo de atributo, escribe el atributo actual y, a continuación, el resto de los atributos hasta la etiqueta de cierre del elemento.- For an attribute node, it writes the current attribute, and then the rest of the attributes until the element closing tag.
-Para un nodo de elemento, escribe todos los atributos que contiene el elemento.- For an element node, it writes all attributes contained by the element.
-Para un nodo de declaración XML, escribe todos los atributos en la declaración.- For an XML declaration node, it writes all the attributes in the declaration.
-Para todos los demás tipos de nodo, el método produce una excepción.- For all other node types, the method throws an exception.

Controlar espacios de nombresHandling namespaces

Los espacios de nombres se utilizan para calificar nombres de atributos y elementos en un documento XML.Namespaces are used to qualify element and attribute names in an XML document. Los prefijos de Namespace asocian elementos y atributos con espacios de nombres, que están asociadas a su vez con referencias URI.Namespace prefixes associate elements and attributes with namespaces, which are in turn associated with URI references. Los espacios de nombres crean nombres de elementos y atributos únicos en un documento XML.Namespaces create element and attribute name uniqueness in an XML document.

El XmlWriter mantiene una pila de espacio de nombres que corresponde a todos los espacios de nombres definidos en el ámbito de espacio de nombres actual.The XmlWriter maintains a namespace stack that corresponds to all the namespaces defined in the current namespace scope. A la hora de escribir elementos y atributos, puede utilizar espacios de nombres de las siguientes formas:When writing elements and attributes you can utilize namespaces in the following ways:

  • Declarar espacios de nombres manualmente mediante el WriteAttributeString método.Declare namespaces manually by using the WriteAttributeString method. Esto puede resultar útil si conoce la mejor forma de optimizar el número de declaraciones de espacios de nombres.This can be useful when you know how to best optimize the number of namespace declarations. Para obtener un ejemplo, vea el WriteAttributeString(String, String, String, String) método.For an example, see the WriteAttributeString(String, String, String, String) method.

  • Invalidar la declaración de espacio de nombres actual con un espacio de nombres nuevo.Override the current namespace declaration with a new namespace. En el código siguiente, la WriteAttributeString método cambia el URI de espacio de nombres para el "x" prefijo de "123" a "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()
    

    El código genera la siguiente cadena XML:The code generates the following XML string:

    <x:root xmlns:x="123">  
      <item xmlns:x="abc" />  
    </x:root>  
    
  • Especifique un prefijo de espacio de nombres al escribir atributos o elementos.Specify a namespace prefix when writing attributes or elements. Muchos de los métodos usados para escribir elementos y atributos le permiten hacer esto.Many of the methods used to write element and attributes enable you to do this. Por ejemplo, el WriteStartElement(String, String, String) método escribe una etiqueta de apertura y lo asocia con un espacio de nombres especificado y un prefijo.For example, the WriteStartElement(String, String, String) method writes a start tag and associates it with a specified namespace and prefix.

Escribir datos de tipoWriting typed data

El WriteValue método acepta un objeto de common language runtime (CLR), convierte el valor de entrada a su representación de cadena según las reglas de conversión de tipos de datos XML schema definition language (XSD) y escribe utilizando el WriteString 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. Esto es más fácil que con los métodos en el XmlConvert clase para convertir los datos con tipo a un valor de cadena antes de escribirlo.This is easier than using the methods in the XmlConvert class to convert the typed data to a string value before writing it out.

Cuando se escribe en texto, el valor con tipo se serializa en texto utilizando la XmlConvert reglas para ese tipo de esquema.When writing to text, the typed value is serialized to text by using the XmlConvert rules for that schema type.

Para los tipos de datos XSD en el valor predeterminado que corresponden a tipos CLR, vea el WriteValue método.For default XSD data types that correspond to CLR types, see the WriteValue method.

El XmlWriter también se puede usar para escribir en un almacén de datos XML.The XmlWriter can also be used to write to an XML data store. Por ejemplo, la clase XPathNavigator puede crear un objeto XmlWriter para crear nodos para un objeto XmlDocument.For example, the XPathNavigator class can create an XmlWriter object to create nodes for an XmlDocument object. Si el almacén de datos tiene información de esquema, el WriteValue método produce una excepción si se intenta convertir un tipo que no está permitido. Si el almacén de datos no tiene información de esquema, el WriteValue método trata todos los valores como un xsd:anySimpleType 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.

El escritor XML de cierreClosing the XML writer

Cuando usas XmlWriter métodos a la salida XML, los elementos y atributos no se escriben hasta que llame a la Close método.When you use XmlWriter methods to output XML, the elements and attributes are not written until you call the Close method. Por ejemplo, si usas XmlWriter para rellenar un XmlDocument objeto, no podrá ver los elementos y atributos escritos en el documento de destino hasta que cierre el XmlWriter instancia.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.

Programación asincrónicaAsynchronous programming

La mayoría de los XmlWriter métodos tienen equivalentes asincrónicos que tienen "Async" al final de los nombres de método.Most of the XmlWriter methods have asynchronous counterparts that have "Async" at the end of their method names. Por ejemplo, el equivalente asincrónico de WriteAttributeString es WriteAttributeStringAsync.For example, the asynchronous equivalent of WriteAttributeString is WriteAttributeStringAsync.

Para el WriteValue método, que no tener un homólogo asincrónico, convertir el valor devuelto en una cadena y usar el WriteStringAsync método en su lugar.For the WriteValue method, which doesn't have an asynchronous counterpart, convert the return value to a string and use the WriteStringAsync method instead.

Consideraciones de seguridadSecurity considerations

Tenga en cuenta lo siguiente al trabajar con el XmlWriter clase:Consider the following when working with the XmlWriter class:

  • Las excepciones producidas por la XmlWriter pueden revelar información de ruta de acceso que no desea que se ejecuta hasta la aplicación.Exceptions thrown by the XmlWriter can disclose path information that you do not want bubbled up to the app. La aplicación debe detectar las excepciones y procesarlas adecuadamente.Your app must catch exceptions and process them appropriately.

  • XmlWriter no valida los datos que se pasan a la WriteDocType o WriteRaw método.XmlWriter does not validate any data that is passed to the WriteDocType or WriteRaw method. No se deben pasar datos arbitrarios a estos métodos.You should not pass arbitrary data to these methods.

Constructores

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

Inicializa una nueva instancia de la clase XmlWriter.Initializes a new instance of the XmlWriter class.

Propiedades

Settings Settings Settings Settings

Obtiene el objeto XmlWriterSettings que se usa para crear esta instancia de XmlWriter.Gets the XmlWriterSettings object used to create this XmlWriter instance.

WriteState WriteState WriteState WriteState

Cuando se invalida en una clase derivada, obtiene el estado del sistema de escritura.When overridden in a derived class, gets the state of the writer.

XmlLang XmlLang XmlLang XmlLang

Cuando se invalida en una clase derivada, obtiene el ámbito de xml:lang actual.When overridden in a derived class, gets the current xml:lang scope.

XmlSpace XmlSpace XmlSpace XmlSpace

Cuando se invalida en una clase derivada, se obtiene un XmlSpace que representa el ámbito de xml:space actual.When overridden in a derived class, gets an XmlSpace representing the current xml:space scope.

Métodos

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

Cuando se invalida en una clase derivada, cierra este flujo y el flujo subyacente.When overridden in a derived class, closes this stream and the underlying stream.

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

Crea una nueva instancia de XmlWriter mediante la secuencia especificada.Creates a new XmlWriter instance using the specified stream.

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

Crea una nueva instancia de XmlWriter mediante la secuencia y el objeto XmlWriterSettings.Creates a new XmlWriter instance using the stream and XmlWriterSettings object.

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

Crea una nueva instancia de XmlWriter mediante el nombre de archivo especificado.Creates a new XmlWriter instance using the specified filename.

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

Crea una nueva instancia de XmlWriter mediante el nombre de archivo y el objeto XmlWriterSettings.Creates a new XmlWriter instance using the filename and XmlWriterSettings object.

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

Crea una nueva instancia de XmlWriter mediante el objeto StringBuilder especificado.Creates a new XmlWriter instance using the specified StringBuilder.

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

Crea una nueva instancia de XmlWriter mediante los objetos StringBuilder y XmlWriterSettings.Creates a new XmlWriter instance using the StringBuilder and XmlWriterSettings objects.

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

Crea una nueva instancia de XmlWriter mediante el objeto TextWriter especificado.Creates a new XmlWriter instance using the specified TextWriter.

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

Crea una nueva instancia de XmlWriter mediante los objetos TextWriter y XmlWriterSettings.Creates a new XmlWriter instance using the TextWriter and XmlWriterSettings objects.

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

Crea una nueva instancia de XmlWriter mediante el 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)

Crea una nueva instancia de XmlWriter mediante los objetos XmlWriter y XmlWriterSettings especificados.Creates a new XmlWriter instance using the specified XmlWriter and XmlWriterSettings objects.

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

Libera todos los recursos usados por la instancia actual de la clase XmlWriter.Releases all resources used by the current instance of the XmlWriter class.

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

Libera los recursos no administrados que usa XmlWriter y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the XmlWriter and optionally releases the managed resources.

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

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Flush() Flush() Flush() Flush()

Cuando se invalida en una clase derivada, vuelca el contenido del búfer en los flujos subyacentes y también vuelca el flujo subyacente.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()

Vuelca asincrónicamente el contenido del búfer en los flujos subyacentes y también vuelca el flujo subyacente.Asynchronously flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
LookupPrefix(String) LookupPrefix(String) LookupPrefix(String) LookupPrefix(String)

Cuando se invalida en una clase derivada, devuelve el prefijo más próximo definido en el ámbito de espacio de nombres actual correspondiente al identificador URI de espacio de nombres.When overridden in a derived class, returns the closest prefix defined in the current namespace scope for the namespace URI.

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

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

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

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

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

Cuando se invalida en una clase derivada, escribe todos los atributos que se encuentran en la posición actual en 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)

De forma asincrónica escribe todos los atributos encontrados en la posición actual en 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)

Cuando se invalida en una clase derivada, escribe el atributo con el valor y nombre local 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)

Cuando se invalida en una clase derivada, escribe un atributo con el valor, nombre local e identificador URI del espacio de nombres 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)

Cuando se invalida en una clase derivada, escribe el atributo con el prefijo, el nombre local, el identificador URI de espacio de nombres y el 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)

Escribe asincrónicamente un atributo con el prefijo, el nombre local, el URI del espacio de nombres y el valor especificados.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)

Cuando se invalida en una clase derivada, codifica los bytes binarios especificados en Base64 y escribe el 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 asincrónicamente los bytes binarios especificados en Base64 y escribe el 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)

Cuando se invalida en una clase derivada, codifica los bytes binarios especificados en BinHex y escribe el 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 asincrónicamente los bytes binarios especificados como BinHex y escribe el texto resultante.Asynchronously encodes the specified binary bytes as BinHex and writes out the resulting text.

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

Cuando se invalida en una clase derivada, escribe un bloque <![CDATA[...]]> que contiene el 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)

Escribe asincrónicamente un bloque <![CDATA[...]]> que contiene el texto especificado.Asynchronously writes out a <![CDATA[...]]> block containing the specified text.

WriteCharEntity(Char) WriteCharEntity(Char) WriteCharEntity(Char) WriteCharEntity(Char)

Cuando se invalida en una clase derivada, impone la generación de una entidad de caracteres para el valor de carácter Unicode especificado.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)

Impone asincrónicamente la generación de una entidad de caracteres para el valor de carácter 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)

Cuando se invalida en una clase derivada, escribe texto en un búfer cada 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)

Escribe asincrónicamente texto en un búfer cada vez.Asynchronously writes text one buffer at a time.

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

Cuando se invalida en una clase derivada, escribe un comentario <!--...--> que contiene el texto especificado.When overridden in a derived class, writes out a comment <!--...--> containing the specified text.

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

De forma asincrónica escribe un comentario <!--...--> que contiene el 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)

Cuando se invalida en una clase derivada, escribe la declaración DOCTYPE con el nombre y atributos opcionales especificados.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)

Escribe asincrónicamente la declaración DOCTYPE con el nombre y los atributos opcionales especificados.Asynchronously writes the DOCTYPE declaration with the specified name and optional attributes.

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

Escribe un elemento con el nombre local y el valor 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)

Escribe un elemento con el nombre local especificado, el URI de espacio de nombres y el valor.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)

Escribe un elemento con el prefijo, nombre local, el URI de espacio de nombres y el 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)

Escribe asincrónicamente un elemento con el nombre local, el URI de espacio de nombres, el valor y el prefijo especificados.Asynchronously writes an element with the specified prefix, local name, namespace URI, and value.

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

Cuando se invalida en una clase derivada, cierra la llamada a WriteStartAttribute(String, String) anterior.When overridden in a derived class, closes the previous WriteStartAttribute(String, String) call.

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

Cierra de forma asincrónica la llamada anterior al método WriteStartAttribute(String, String) .Asynchronously closes the previous WriteStartAttribute(String, String) call.

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

Cuando se invalida en una clase derivada, cierra todos los elementos o atributos abiertos y vuelve a colocar el sistema de escritura en el estado de inicio.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()

Cierra asincrónicamente todos los elementos o atributos abiertos y coloca de nuevo el sistema de escritura en el estado de inicio.Asynchronously closes any open elements or attributes and puts the writer back in the Start state.

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

Cuando se invalida en una clase derivada, cierra un elemento y extrae el ámbito de espacio de nombres correspondiente.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

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

Cierra asincrónicamente un elemento y extrae el correspondiente ámbito de espacio de nombres.Asynchronously closes one element and pops the corresponding namespace scope.

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

Cuando se invalida en una clase derivada, escribe una referencia a entidad de la siguiente forma: &name;.When overridden in a derived class, writes out an entity reference as &name;.

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

De forma asincrónica coloca una referencia de entidad en tipo como &name;.Asynchronously writes out an entity reference as &name;.

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

Cuando se invalida en una clase derivada, cierra un elemento y extrae el ámbito de espacio de nombres correspondiente.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

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

Cierra asincrónicamente un elemento y extrae el correspondiente ámbito de espacio de nombres.Asynchronously closes one element and pops the corresponding namespace scope.

WriteName(String) WriteName(String) WriteName(String) WriteName(String)

Cuando se invalida en una clase derivada, escribe el nombre especificado, comprobando que sea un nombre válido de acuerdo con la recomendación relativa a XML 1.0 del Consorcio W3C (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)

Escribe asincrónicamente el nombre especificado, asegurando que se trata de un nombre válido de acuerdo con la recomendación relativa a XML 1.0 del Consorcio W3C (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)

Cuando se invalida en una clase derivada, escribe el nombre especificado, comprobando que sea un NmToken válido de acuerdo con la recomendación relativa a XML 1.0 del Consorcio W3C (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)

Escribe asincrónicamente el nombre especificado, asegurando que se trata de un NmToken válido de acuerdo con la recomendación relativa a XML 1.0 del Consorcio W3C (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)

Cuando se invalida en una clase derivada, copia todo el contenido del lector en el sistema de escritura y desplaza el lector al inicio del siguiente nodo relacionado.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 todo el contenido del objeto XPathNavigator en el sistema de escritura.Copies everything from the XPathNavigator object to the writer. La posición de XPathNavigator permanece inalterada.The position of the XPathNavigator remains unchanged.

WriteNodeAsync(XmlReader, Boolean) WriteNodeAsync(XmlReader, Boolean) WriteNodeAsync(XmlReader, Boolean) WriteNodeAsync(XmlReader, Boolean)

Copia asincrónicamente todo el contenido del lector en el sistema de escritura y desplaza el lector al inicio del siguiente nodo relacionado.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)

De forma asincrónica copia todo el objeto de XPathNavigator al escritor.Asynchronously copies everything from the XPathNavigator object to the writer. La posición de XPathNavigator permanece inalterada.The position of the XPathNavigator remains unchanged.

WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String)

Cuando se invalida en una clase derivada, escribe una instrucción de procesamiento con un espacio entre el nombre y el texto: <?nombre 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)

Escribe de forma asincrónica una instrucción de procesamiento con un espacio entre el nombre y el texto: <?nombre 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)

Cuando se invalida en una clase derivada, escribe el nombre completo del espacio de nombres.When overridden in a derived class, writes out the namespace-qualified name. Este método busca un prefijo que está en el ámbito del espacio de nombres especificado.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)

Escribe asincrónicamente el nombre completo del espacio de nombres.Asynchronously writes out the namespace-qualified name. Este método busca un prefijo que está en el ámbito del espacio de nombres especificado.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)

Cuando se invalida en una clase derivada, escribe marcado sin formato manualmente desde un búfer de caracteres.When overridden in a derived class, writes raw markup manually from a character buffer.

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

Cuando se invalida en una clase derivada, escribe marcado sin formato manualmente desde una cadena.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)

Escribe asincrónicamente el marcado sin formato de un búfer de caracteres.Asynchronously writes raw markup manually from a character buffer.

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

Escribe asincrónicamente el marcado sin formato de una cadena.Asynchronously writes raw markup manually from a string.

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

Escribe el inicio de un atributo con el nombre 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)

Escribe el inicio de un atributo con el URI de espacio de nombres y el nombre local 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)

Cuando se invalida en una clase derivada, escribe el inicio de un atributo con el prefijo, el nombre local y el URI de espacio de nombres especificados.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)

Escribe asincrónicamente el inicio de un atributo con el prefijo, URI de espacio de nombres y el nombre local especificados.Asynchronously writes the start of an attribute with the specified prefix, local name, and namespace URI.

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

Cuando se invalida en una clase derivada, escribe la declaración XML con la versión "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)

Cuando se invalida en una clase derivada, escribe la declaración XML con la versión "1.0" y el atributo independiente.When overridden in a derived class, writes the XML declaration with the version "1.0" and the standalone attribute.

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

Escribe asincrónicamente la declaración XML con la versión "1.0".Asynchronously writes the XML declaration with the version "1.0".

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

Escribe asincrónicamente la declaración XML con la versión "1.0" así como el atributo independiente.Asynchronously writes the XML declaration with the version "1.0" and the standalone attribute.

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

Cuando se invalida en una clase derivada, escribe una etiqueta de apertura con el nombre 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)

Cuando se invalida en una clase derivada, escribe la etiqueta de apertura especificada y la asocia al espacio de nombres especificado.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)

Cuando se invalida en una clase derivada, escribe la etiqueta de apertura especificada y la asocia al espacio de nombres y prefijo especificados.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)

Escribe asincrónicamente la etiqueta de apertura especificada y la asocia al espacio de nombres y al prefijo especificados.Asynchronously writes the specified start tag and associates it with the given namespace and prefix.

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

Cuando se invalida en una clase derivada, escribe el contenido de texto especificado.When overridden in a derived class, writes the given text content.

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

Escribe asincrónicamente el contenido de texto dado.Asynchronously writes the given text content.

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

Cuando se invalida en una clase derivada, genera y escribe la entidad de carácter suplente para el par de caracteres suplentes.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)

Genera y escribe asincrónicamente la entidad de carácter suplente del par de caracteres suplentes.Asynchronously generates and writes the surrogate character entity for the surrogate character pair.

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

Escribe un valor Boolean.Writes a Boolean value.

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

Escribe un valor DateTime.Writes a DateTime value.

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

Escribe un valor DateTimeOffset.Writes a DateTimeOffset value.

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

Escribe un valor Decimal.Writes a Decimal value.

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

Escribe un valor Double.Writes a Double value.

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

Escribe un valor Int32.Writes a Int32 value.

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

Escribe un valor Int64.Writes a Int64 value.

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

Escribe el valor del objeto.Writes the object value.

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

Escribe un número de punto flotante de precisión sencilla.Writes a single-precision floating-point number.

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

Escribe un valor String.Writes a String value.

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

Cuando se invalida en una clase derivada, escribe el espacio en blanco especificado.When overridden in a derived class, writes out the given white space.

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

Escribe asincrónicamente el espacio en blanco especificado.Asynchronously writes out the given white space.

Implementaciones de interfaz explícitas

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

Para obtener una descripción de este miembro, vea Dispose().For a description of this member, see Dispose().

Se aplica a

Consulte también: