XmlWriter Clase

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
XmlWriter
Derivado
Implementaciones

Ejemplos

En el ejemplo de código siguiente se 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, un archivo, un lector de texto o una cadena.The XmlWriter class writes XML data to a stream, file, text reader, or string. Admite las recomendaciones W3C lenguaje de marcado extensible (XML) 1,0 (cuarta edición) y espacios de nombres en XML 1,0 (tercera edición) .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.

  • Codifique los bytes binarios como base64 o BinHex y escriba el texto resultante.Encode binary bytes as Base64 or BinHex, and write out the resulting text.

  • Pase valores mediante Common Language Runtime tipos en lugar de cadenas para evitar tener que realizar conversiones de valores manualmente.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:

Crear un escritor XML Creating an XML writer
Especificar el formato de salida Specifying the output format
Cumplimiento de datos Data conformance
Escribir elementos Writing elements
Escribir atributos Writing attributes
Controlar espacios de nombres Handling namespaces
Escribir datos con tipo Writing typed data
Cierre del escritor XML Closing the XML writer
Programación asincrónica Asynchronous programming
Consideraciones de seguridadSecurity considerations

Crear un escritor XMLCreating an XML writer

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

Especificar el formato de salidaSpecifying the output format

La XmlWriterSettings clase incluye varias propiedades que controlan XmlWriter cómo se da formato a los resultados: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 false es (sin 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 controlar 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)

NewLineOnAttributes Utilice 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 de datosData conformance

Un escritor de XML usa dos propiedades de XmlWriterSettings la clase para comprobar la conformidad de los datos:An XML writer uses two properties from the XmlWriterSettings class to check for data conformance:

  • La CheckCharacters propiedad indica al escritor de XML que compruebe los caracteres e inicie XmlException una excepción si alguno de los caracteres está fuera del intervalo legal, tal como se define en 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.

  • La ConformanceLevel propiedad configura el escritor de XML para comprobar que la secuencia que se está escribiendo cumple las reglas de un fragmento de documento o documento XML 1,0 correcto, tal como se define en 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. Los tres niveles de cumplimiento se describen 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, XmlWriterSettings.ConformanceLevel vea la propiedad System.Xml.ConformanceLevel y la 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 se puede procesar con 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 de 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 de XML determina qué nivel de comprobación de conformidad se aplica (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.

Escribir elementosWriting elements

Puede usar los métodos siguientes XmlWriter para escribir nodos de elementos.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 Escribe un nodo de elemento completo, incluido un valor de cadena.Write an entire element node, including a string value.
WriteStartElement Para escribir un valor de elemento mediante el uso de 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 WriteElementString del método.This is a more sophisticated version of the WriteElementString method.

Para cerrar el elemento, llame al WriteEndElement método o. WriteFullEndElementTo close the element, you call the WriteEndElement or WriteFullEndElement method.
WriteNode Para copiar un nodo de elemento que se encuentra en la posición XmlReader actual XPathNavigator de un objeto o.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 usar los métodos siguientes XmlWriter para escribir atributos en nodos de elementos.You can use the following XmlWriter methods to write attributes on element nodes. Estos métodos también se pueden usar para crear 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 atributo completo, incluido un valor de cadena.To write an entire attribute node, including a string value.
WriteStartAttribute Para escribir el valor de atributo mediante varias llamadas a métodos.To write the attribute value using multiple method calls. Por ejemplo, puede llamar WriteValue a 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 WriteElementString del método.This is a more sophisticated version of the WriteElementString method.

Para cerrar el elemento, llame al WriteEndAttribute método.To close the element, you call the WriteEndAttribute method.
WriteAttributes Para copiar todos los atributos que se encuentran en la posición actual XmlReader de un 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 en el 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, después, 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 de 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 espacio de nombres asocian elementos y atributos con espacios de nombres que, a su vez, están asociados a referencias de 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.

XmlWriter Mantiene una pila de espacios de nombres que corresponde a todos los espacios de nombres definidos en el ámbito del 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:

  • Declare los espacios de nombres manualmente WriteAttributeString mediante el 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 WriteAttributeString(String, String, String, String) el 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, el WriteAttributeString método cambia el URI del espacio de "x" nombres para "123" el "abc"prefijo de a.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 que se usan 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 la asocia a un espacio de nombres y prefijo especificados.For example, the WriteStartElement(String, String, String) method writes a start tag and associates it with a specified namespace and prefix.

Escribir datos con tipoWriting typed data

El WriteValue método acepta un objeto Common Language Runtime (CLR), convierte el valor de entrada en su representación de cadena de acuerdo con las reglas de conversión del tipo de datos del lenguaje de definición de esquemas XML ( WriteString XSD) y lo escribe utilizando el 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 usar los métodos de XmlConvert la clase para convertir los datos con tipo en 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.

Al escribir en el texto, el valor con tipo se serializa en el texto mediante el XmlConvert uso de las 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 obtener información sobre los tipos de datos XSD predeterminados que WriteValue corresponden a los tipos CLR, vea el método.For default XSD data types that correspond to CLR types, see the WriteValue method.

También XmlWriter se puede utilizar 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 disponible información de esquema, el WriteValue método produce una excepción si se intenta convertir en un tipo que no está permitido. Si el almacén de datos no tiene disponible 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.

Cierre del escritor XMLClosing the XML writer

Cuando se usan XmlWriter métodos para generar XML, los elementos y atributos no se escriben hasta que se Close llama al 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 usa XmlWriter para rellenar un XmlDocument objeto, no podrá ver los elementos y atributos escritos en el documento de destino hasta que cierre la 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 XmlWriter los métodos tienen homólogos asincrónicos que tienen "Async" al final de sus 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. WriteAttributeStringAsyncFor example, the asynchronous equivalent of WriteAttributeString is WriteAttributeStringAsync.

En el WriteValue caso del método, que no tiene un homólogo asincrónico, convierta el valor devuelto en una cadena WriteStringAsync y use el 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 XmlWriter con la clase:Consider the following when working with the XmlWriter class:

  • Las XmlWriter excepciones producidas por pueden revelar información de la ruta de acceso que no desea que se propague a 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 de forma adecuada.Your app must catch exceptions and process them appropriately.

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

Constructores

XmlWriter()

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

Propiedades

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

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

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

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()

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)

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

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)

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

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)

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

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)

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

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)

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

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()

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)

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)

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

(Heredado de Object)
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()

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()

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

(Heredado de Object)
GetType()

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

(Heredado de Object)
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()

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

(Heredado de Object)
ToString()

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

(Heredado de Object)
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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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

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)

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)

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)

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

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)

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)

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)

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)

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)

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)

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)

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()

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()

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

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()

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()

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()

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)

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)

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

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()

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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

WriteRawAsync(String)

Escribe asincrónicamente el marcado sin formato de una cadena.Asynchronously writes raw markup manually from a 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)

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)

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)

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()

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)

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()

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)

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)

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)

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)

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)

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)

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)

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

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)

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)

Escribe un valor Boolean.Writes a Boolean value.

WriteValue(DateTime)

Escribe un valor DateTime.Writes a DateTime value.

WriteValue(DateTimeOffset)

Escribe un valor DateTimeOffset.Writes a DateTimeOffset value.

WriteValue(Decimal)

Escribe un valor Decimal.Writes a Decimal value.

WriteValue(Double)

Escribe un valor Double.Writes a Double value.

WriteValue(Int32)

Escribe un valor Int32.Writes a Int32 value.

WriteValue(Int64)

Escribe un valor Int64.Writes a Int64 value.

WriteValue(Object)

Escribe el valor del objeto.Writes the object value.

WriteValue(Single)

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

WriteValue(String)

Escribe un valor String.Writes a String value.

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)

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

Implementaciones de interfaz explícitas

IDisposable.Dispose()

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

Se aplica a

Consulte también: