XmlTextWriter XmlTextWriter XmlTextWriter XmlTextWriter Class

Definición

Representa un sistema de escritura que proporciona un medio rápido, sin almacenamiento en caché y con desplazamiento sólo hacia delante para generar secuencias o archivos con datos XML que satisface las recomendaciones relativas a espacios de nombres en XML y Extensible Markup Language (XML) 1.0 del Consorcio W3C.Represents a writer that provides a fast, non-cached, forward-only way of generating streams or files containing XML data that conforms to the W3C Extensible Markup Language (XML) 1.0 and the Namespaces in XML recommendations.

A partir de .NET Framework 2.0, se recomienda usar la clase XmlWriter en su lugar.Starting with the .NET Framework 2.0, we recommend that you use the XmlWriter class instead.

public ref class XmlTextWriter : System::Xml::XmlWriter
public class XmlTextWriter : System.Xml.XmlWriter
type XmlTextWriter = class
    inherit XmlWriter
Public Class XmlTextWriter
Inherits XmlWriter
Herencia
XmlTextWriterXmlTextWriterXmlTextWriterXmlTextWriter

Comentarios

Esta clase implementa la XmlWriter clase.This class implements the XmlWriter class.

Nota

A partir de .NET Framework 2.0, se recomienda crear XmlWriter instancias utilizando el XmlWriter.Create método y el XmlWriterSettings clase para aprovechar las ventajas de la nueva funcionalidad.Starting with the .NET Framework 2.0, we recommend that you create XmlWriter instances by using the XmlWriter.Create method and the XmlWriterSettings class to take advantage of new functionality.

XmlTextWriter mantiene una pila de espacio de nombres correspondiente a todos los espacios de nombres definidos en la pila del elemento actual.XmlTextWriter maintains a namespace stack corresponding to all the namespaces defined in the current element stack. Uso de XmlTextWriter puede declarar espacios de nombres manualmente.Using XmlTextWriter you can declare namespaces manually.

w.WriteStartElement("root");  
w.WriteAttributeString("xmlns", "x", null, "urn:1");  
 w.WriteStartElement("item","urn:1");  
 w.WriteEndElement();  
 w.WriteStartElement("item","urn:1");  
 w.WriteEndElement();  
w.WriteEndElement();  

El código de C# anterior genera el resultado siguiente.The above C# code produces the following output. XmlTextWriter promociona la declaración de espacio de nombres al elemento raíz para evitar que esté duplicada en los dos elementos secundarios.XmlTextWriter promotes the namespace declaration to the root element to avoid having it duplicated on the two child elements. Los elementos secundarios obtienen el prefijo de la declaración de espacio de nombres.The child elements pick up the prefix from the namespace declaration.

<root xmlns:x="urn:1">  
 <x:item/>  
 <x:item/>  
</x:root>  

XmlTextWriter También permite reemplazar la declaración de espacio de nombres actual.XmlTextWriter also allows you to override the current namespace declaration. En el ejemplo siguiente, el espacio de nombres URI "123" se reemplaza por "abc" para generar el elemento XML <x:node xmlns:x="abc"/>.In the following example, the namespace URI "123" is overridden by "abc" to produce the XML element <x:node xmlns:x="abc"/>.

w.WriteStartElement("x","node","123");  
w.WriteAttributeString("xmlns","x",null,"abc");  

Mediante el uso de los métodos de escritura que toman un prefijo como argumento también puede especificar qué prefijo se va a usar.By using the write methods that take a prefix as an argument you can also specify which prefix to use. En el ejemplo siguiente, se asignan dos prefijos diferentes al mismo espacio de nombres URI para generar el texto XML <x:root xmlns:x="urn:1"><y:item xmlns:y="urn:1"/></x:root>.In the following example, two different prefixes are mapped to the same namespace URI to produce the XML text <x:root xmlns:x="urn:1"><y:item xmlns:y="urn:1"/></x:root>.

XmlTextWriter w = new XmlTextWriter(Console.Out);  
w.WriteStartElement("x","root","urn:1");  
 w.WriteStartElement("y","item","urn:1");  
 w.WriteEndElement();  
w.WriteEndElement();  
w.Close();  

Si hay varias declaraciones de espacio de nombres que asignan prefijos diferentes al mismo espacio de nombres URI, XmlTextWriter recorre la pila de declaraciones de espacio de nombres con versiones anteriores y elegir el más próximo.If there are multiple namespace declarations mapping different prefixes to the same namespace URI, XmlTextWriter walks the stack of namespace declarations backwards and picks the closest one.

XmlTextWriter w = new XmlTextWriter(Console.Out);  
w.Formatting = Formatting.Indented;  
w.WriteStartElement("x","root","urn:1");  
w.WriteStartElement("y","item","urn:1");  
w.WriteAttributeString("attr","urn:1","123");  
w.WriteEndElement();  
w.WriteEndElement();  
w.Close();  

En el anterior ejemplo de C#, porque el WriteAttributeString llamada no especifica un prefijo, el sistema de escritura utiliza el último prefijo insertado en la pila de espacio de nombres y genera el código XML siguiente:In the above C# example, because the WriteAttributeString call does not specify a prefix, the writer uses the last prefix pushed onto the namespace stack, and produces the following XML:

<x:root xmlns:x="urn:1">  
 <y:item y:attr="123" xmlns:y="urn:1" />  
</x:root>  

Si se producen conflictos de espacio de nombres, XmlTextWriter resuelve mediante la generación de prefijos alternativos.If namespace conflicts occur, XmlTextWriter resolves them by generating alternate prefixes. Por ejemplo, si un atributo y un elemento tienen el mismo prefijo, pero con distintos espacios de nombres, XmlWriter genera otro prefijo para el atributo.For example, if an attribute and element have the same prefix but different namespaces, XmlWriter generates an alternate prefix for the attribute. Los prefijos generados se denominan n{i} donde i es un número que empieza en 1.The generated prefixes are named n{i} where i is a number beginning at 1. El número se restablece en 1 para cada elemento.The number is reset to 1 for each element.

Los atributos que están asociados con un URI de espacio de nombres deben tener un prefijo (valor predeterminado, los espacios de nombres no se aplican a los atributos).Attributes which are associated with a namespace URI must have a prefix (default namespaces do not apply to attributes). Esto se ajusta a la sección 5.2 del W3C recomendación de Namespaces en XML.This conforms to section 5.2 of the W3C Namespaces in XML recommendation. Si un atributo hace referencia a un URI de espacio de nombres, pero no especifica un prefijo, el sistema de escritura genera un prefijo para el atributo.If an attribute references a namespace URI, but does not specify a prefix, the writer generates a prefix for the attribute.

Al escribir un elemento vacío, un espacio adicional se agrega entre el nombre de la etiqueta y la etiqueta de cierre, por ejemplo <item />.When writing an empty element, an additional space is added between tag name and the closing tag, for example <item />. Esto proporciona compatibilidad con exploradores más antiguos.This provides compatibility with older browsers.

Cuando un String se utiliza como parámetro de método, null y String.Empty son equivalentes.When a String is used as method parameter, null and String.Empty are equivalent. String.Empty sigue las reglas del W3C.String.Empty follows the W3C rules.

Para escribir datos fuertemente tipados, use la XmlConvert clase para convertir tipos de datos en cadena.To write strongly typed data, use the XmlConvert class to convert data types to string. Por ejemplo, el siguiente código C# convierte los datos de Double a String y escribe el elemento <price>19.95</price>.For example, the following C# code converts the data from Double to String and writes the element <price>19.95</price>.

Double price = 19.95;  
writer.WriteElementString("price", XmlConvert.ToString(price));  

XmlTextWriter no compruebe lo siguiente:XmlTextWriter does not check for the following:

  • Caracteres no válidos en nombres de atributo y elemento.Invalid characters in attribute and element names.

  • Caracteres Unicode que no se ajustan la codificación especificada.Unicode characters that do not fit the specified encoding. Si los caracteres Unicode no ajustan la codificación especificada, el XmlTextWriter no realiza escape de los caracteres Unicode en las entidades de caracteres.If the Unicode characters do not fit the specified encoding, the XmlTextWriter does not escape the Unicode characters into character entities.

  • Atributos duplicados.Duplicate attributes.

  • Caracteres en el identificador público del tipo de documento o el identificador del sistema.Characters in the DOCTYPE public identifier or system identifier.

Consideraciones de seguridadSecurity Considerations

Los elementos siguientes son las cosas a tener en cuenta al trabajar con el XmlTextWriter clase.The following items are things to consider when working with the XmlTextWriter class.

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

  • Cuando se pasa XmlTextWriter a otra aplicación, la secuencia subyacente queda expuesta a esa aplicación.When you pass the XmlTextWriter to another application the underlying stream is exposed to that application. Si necesita pasar el objeto XmlTextWriter a una aplicación de confianza parcial, debería utilizar en su lugar un objeto XmlWriter creado por el método Create.If you need to pass the XmlTextWriter to a semi-trusted application, you should use an XmlWriter object created by the Create method instead.

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

  • Si se cambia la configuración predeterminada, no hay ninguna garantía de que la salida generada es datos XML con formato correcto.If the default settings are changed, there is no guarantee that the generated output is well-formed XML data.

  • No acepte componentes auxiliares, como un Encoding objeto desde un origen de confianza.Do not accept supporting components, such as an Encoding object, from an untrusted source.

Constructores

XmlTextWriter(Stream, Encoding) XmlTextWriter(Stream, Encoding) XmlTextWriter(Stream, Encoding) XmlTextWriter(Stream, Encoding)

Crea una instancia de la clase XmlTextWriter mediante la secuencia y la codificación especificadas.Creates an instance of the XmlTextWriter class using the specified stream and encoding.

XmlTextWriter(String, Encoding) XmlTextWriter(String, Encoding) XmlTextWriter(String, Encoding) XmlTextWriter(String, Encoding)

Crea una instancia de la clase XmlTextWriter mediante el archivo especificado.Creates an instance of the XmlTextWriter class using the specified file.

XmlTextWriter(TextWriter) XmlTextWriter(TextWriter) XmlTextWriter(TextWriter) XmlTextWriter(TextWriter)

Crea una instancia de la clase XmlTextWriter mediante el objeto TextWriter especificado.Creates an instance of the XmlTextWriter class using the specified TextWriter.

Propiedades

BaseStream BaseStream BaseStream BaseStream

Obtiene el objeto de flujo subyacente.Gets the underlying stream object.

Formatting Formatting Formatting Formatting

Indica cómo se da formato a la salida.Indicates how the output is formatted.

Indentation Indentation Indentation Indentation

Obtiene o establece el número de caracteres IndentChars que se escriben para cada nivel de la jerarquía cuando la propiedad Formatting está establecida en Formatting.Indented.Gets or sets how many IndentChars to write for each level in the hierarchy when Formatting is set to Formatting.Indented.

IndentChar IndentChar IndentChar IndentChar

Obtiene o establece el carácter que se va a utilizar para aplicar sangría cuando la propiedad Formatting se establece en Formatting.Indented.Gets or sets which character to use for indenting when Formatting is set to Formatting.Indented.

Namespaces Namespaces Namespaces Namespaces

Obtiene o establece un valor que indica si se ha de aplicar la compatibilidad de espacio de nombres.Gets or sets a value indicating whether to do namespace support.

QuoteChar QuoteChar QuoteChar QuoteChar

Obtiene o establece qué carácter se va a usar para delimitar los valores de atributo.Gets or sets which character to use to quote attribute values.

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.

(Inherited from XmlWriter)
WriteState WriteState WriteState WriteState

Obtiene el estado del sistema de escritura.Gets the state of the writer.

XmlLang XmlLang XmlLang XmlLang

Obtiene el ámbito de xml:lang actual.Gets the current xml:lang scope.

XmlSpace XmlSpace XmlSpace XmlSpace

Obtiene XmlSpace que representa el ámbito de xml:space actual.Gets an XmlSpace representing the current xml:space scope.

Métodos

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

Cierra este flujo y el flujo subyacente.Closes this stream and the underlying stream.

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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
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()

Vuelca el contenido del búfer en los flujos subyacentes y también vuelca el flujo subyacente.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.

(Inherited from XmlWriter)
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)

Devuelve el prefijo más próximo definido en el ámbito de espacio de nombres actual correspondiente al identificador URI de espacio de nombres.Returns the closest prefix defined in the current namespace scope for the namespace URI.

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

Crea una copia superficial del objeto 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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32)

Codifica los bytes binarios especificados en base64 y escribe el texto resultante.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.

(Inherited from XmlWriter)
WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32)

Codifica los bytes binarios especificados como binhex y escribe el texto resultante.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.

(Inherited from XmlWriter)
WriteCData(String) WriteCData(String) WriteCData(String) WriteCData(String)

Escribe un bloque <![CDATA[...]]> que contiene el texto especificado.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.

(Inherited from XmlWriter)
WriteCharEntity(Char) WriteCharEntity(Char) WriteCharEntity(Char) WriteCharEntity(Char)

Impone la generación de una entidad de caracteres para el valor de carácter Unicode especificado.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.

(Inherited from XmlWriter)
WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32)

Escribe texto en un búfer cada vez.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.

(Inherited from XmlWriter)
WriteComment(String) WriteComment(String) WriteComment(String) WriteComment(String)

Escribe un comentario <!--...--> que contiene el texto especificado.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.

(Inherited from XmlWriter)
WriteDocType(String, String, String, String) WriteDocType(String, String, String, String) WriteDocType(String, String, String, String) WriteDocType(String, String, String, String)

Escribe la declaración DOCTYPE con el nombre y los atributos opcionales especificados.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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
WriteEndAttribute() WriteEndAttribute() WriteEndAttribute() WriteEndAttribute()

Cierra la anterior llamada al método WriteStartAttribute(String, String, String).Closes the previous WriteStartAttribute(String, 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.

(Inherited from XmlWriter)
WriteEndDocument() WriteEndDocument() WriteEndDocument() WriteEndDocument()

Cierra todos los elementos o atributos abiertos y coloca de nuevo el sistema de escritura en el estado de inicio.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.

(Inherited from XmlWriter)
WriteEndElement() WriteEndElement() WriteEndElement() WriteEndElement()

Cierra un elemento y extrae el correspondiente ámbito de espacio de nombres.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.

(Inherited from XmlWriter)
WriteEntityRef(String) WriteEntityRef(String) WriteEntityRef(String) WriteEntityRef(String)

Escribe una referencia a entidad como &name;.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;.

(Inherited from XmlWriter)
WriteFullEndElement() WriteFullEndElement() WriteFullEndElement() WriteFullEndElement()

Cierra un elemento y extrae el correspondiente ámbito de espacio de nombres.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.

(Inherited from XmlWriter)
WriteName(String) WriteName(String) WriteName(String) WriteName(String)

Escribe el nombre especificado y garantiza que se trata de un nombre válido de acuerdo con la recomendación relativa a XML 1.0 de W3C.Writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation.

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

(Inherited from XmlWriter)
WriteNmToken(String) WriteNmToken(String) WriteNmToken(String) WriteNmToken(String)

Escribe el nombre especificado y garantiza que se trata de un elemento NmToken válido de acuerdo con la recomendación relativa a XML 1.0 de W3C.Writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation.

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

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String)

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

(Inherited from XmlWriter)
WriteQualifiedName(String, String) WriteQualifiedName(String, String) WriteQualifiedName(String, String) WriteQualifiedName(String, String)

Escribe el nombre completo del espacio de nombres.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.

(Inherited from XmlWriter)
WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32)

Escribe manualmente el marcado sin formato de un búfer de caracteres.Writes raw markup manually from a character buffer.

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

Escribe manualmente el marcado sin formato de una cadena.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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String)

Escribe el inicio de un atributo.Writes the start of an attribute.

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.

(Inherited from XmlWriter)
WriteStartDocument() WriteStartDocument() WriteStartDocument() WriteStartDocument()

Escribe la declaración XML con la versión "1.0".Writes the XML declaration with the version "1.0".

WriteStartDocument(Boolean) WriteStartDocument(Boolean) WriteStartDocument(Boolean) WriteStartDocument(Boolean)

Escribe la declaración XML con la versión "1.0" así como el atributo independiente.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".

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
WriteStartElement(String, String, String) WriteStartElement(String, String, String) WriteStartElement(String, String, String) WriteStartElement(String, String, String)

Escribe la etiqueta de apertura especificada y la asocia al espacio de nombres y al prefijo especificados.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.

(Inherited from XmlWriter)
WriteString(String) WriteString(String) WriteString(String) WriteString(String)

Escribe el contenido de texto especificado.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.

(Inherited from XmlWriter)
WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char)

Genera y escribe la entidad de carácter suplente del par de caracteres suplentes.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.

(Inherited from XmlWriter)
WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean)

Escribe un valor Boolean.Writes a Boolean value.

(Inherited from XmlWriter)
WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime)

Escribe un valor DateTime.Writes a DateTime value.

(Inherited from XmlWriter)
WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset)

Escribe un valor DateTimeOffset.Writes a DateTimeOffset value.

(Inherited from XmlWriter)
WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal)

Escribe un valor Decimal.Writes a Decimal value.

(Inherited from XmlWriter)
WriteValue(Double) WriteValue(Double) WriteValue(Double) WriteValue(Double)

Escribe un valor Double.Writes a Double value.

(Inherited from XmlWriter)
WriteValue(Int32) WriteValue(Int32) WriteValue(Int32) WriteValue(Int32)

Escribe un valor Int32.Writes a Int32 value.

(Inherited from XmlWriter)
WriteValue(Int64) WriteValue(Int64) WriteValue(Int64) WriteValue(Int64)

Escribe un valor Int64.Writes a Int64 value.

(Inherited from XmlWriter)
WriteValue(Object) WriteValue(Object) WriteValue(Object) WriteValue(Object)

Escribe el valor del objeto.Writes the object value.

(Inherited from XmlWriter)
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.

(Inherited from XmlWriter)
WriteValue(String) WriteValue(String) WriteValue(String) WriteValue(String)

Escribe un valor String.Writes a String value.

(Inherited from XmlWriter)
WriteWhitespace(String) WriteWhitespace(String) WriteWhitespace(String) WriteWhitespace(String)

Escribe el espacio en blanco especificado.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.

(Inherited from XmlWriter)

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

(Inherited from XmlWriter)

Se aplica a

Consulte también: