XmlWriter Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.
public ref class XmlWriter abstract : IDisposable
public ref class XmlWriter abstract : IAsyncDisposable, IDisposable
public ref class XmlWriter abstract
public abstract class XmlWriter : IDisposable
public abstract class XmlWriter : IAsyncDisposable, IDisposable
public abstract class XmlWriter
type XmlWriter = class
interface IDisposable
type XmlWriter = class
interface IAsyncDisposable
interface IDisposable
type XmlWriter = class
Public MustInherit Class XmlWriter
Implements IDisposable
Public MustInherit Class XmlWriter
Implements IAsyncDisposable, IDisposable
Public MustInherit Class XmlWriter
- Herencia
-
XmlWriter
- Derivado
- Implementaciones
Ejemplos
En el código de ejemplo siguiente se muestra cómo usar la API asincrónica para generar 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
Para obtener más información sobre esta API, consulte Comentarios complementarios de la API para XmlWriter.
Constructores
XmlWriter() |
Inicializa una nueva instancia de la clase XmlWriter. |
Propiedades
Settings |
Obtiene el objeto XmlWriterSettings que se usa para crear esta instancia de XmlWriter. |
WriteState |
Cuando se invalida en una clase derivada, obtiene el estado del sistema de escritura. |
XmlLang |
Cuando se invalida en una clase derivada, obtiene el ámbito de |
XmlSpace |
Cuando se invalida en una clase derivada, se obtiene un XmlSpace que representa el ámbito de |
Métodos
Close() |
Cuando se invalida en una clase derivada, cierra este flujo y el flujo subyacente. |
Create(Stream) |
Crea una nueva instancia de XmlWriter mediante la secuencia especificada. |
Create(Stream, XmlWriterSettings) |
Crea una nueva instancia de XmlWriter mediante la secuencia y el objeto XmlWriterSettings. |
Create(String) |
Crea una nueva instancia de XmlWriter mediante el nombre de archivo especificado. |
Create(String, XmlWriterSettings) |
Crea una nueva instancia de XmlWriter mediante el nombre de archivo y el objeto XmlWriterSettings. |
Create(StringBuilder) |
Crea una nueva instancia de XmlWriter mediante el objeto StringBuilder especificado. |
Create(StringBuilder, XmlWriterSettings) |
Crea una nueva instancia de XmlWriter mediante los objetos StringBuilder y XmlWriterSettings. |
Create(TextWriter) |
Crea una nueva instancia de XmlWriter mediante el objeto TextWriter especificado. |
Create(TextWriter, XmlWriterSettings) |
Crea una nueva instancia de XmlWriter mediante los objetos TextWriter y XmlWriterSettings. |
Create(XmlWriter) |
Crea una nueva instancia de XmlWriter mediante el objeto XmlWriter especificado. |
Create(XmlWriter, XmlWriterSettings) |
Crea una nueva instancia de XmlWriter mediante los objetos XmlWriter y XmlWriterSettings especificados. |
Dispose() |
Libera todos los recursos usados por la instancia actual de la clase XmlWriter. |
Dispose(Boolean) |
Libera los recursos no administrados que usa XmlWriter y, de forma opcional, libera los recursos administrados. |
DisposeAsync() |
Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados de forma asincrónica. |
DisposeAsyncCore() |
Realiza tareas definidas por la aplicación asociadas a la liberación, liberación o restablecimiento de recursos administrados de forma asincrónica. |
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (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. |
FlushAsync() |
Vuelca asincrónicamente el contenido del búfer en los flujos subyacentes y también vuelca el flujo subyacente. |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetType() |
Obtiene el Type de la instancia actual. (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. |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
ToString() |
Devuelve una cadena que representa el objeto actual. (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. |
WriteAttributesAsync(XmlReader, Boolean) |
De forma asincrónica escribe todos los atributos encontrados en la posición actual en XmlReader. |
WriteAttributeString(String, String) |
Cuando se invalida en una clase derivada, escribe el atributo con el valor y nombre local especificados. |
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. |
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. |
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. |
WriteBase64(Byte[], Int32, Int32) |
Cuando se invalida en una clase derivada, codifica los bytes binarios especificados en Base64 y escribe el texto resultante. |
WriteBase64Async(Byte[], Int32, Int32) |
Codifica asincrónicamente los bytes binarios especificados en Base64 y escribe el texto resultante. |
WriteBinHex(Byte[], Int32, Int32) |
Cuando se invalida en una clase derivada, codifica los bytes binarios especificados en |
WriteBinHexAsync(Byte[], Int32, Int32) |
Codifica asincrónicamente los bytes binarios especificados como |
WriteCData(String) |
Cuando se invalida en una clase derivada, escribe un bloque <![CDATA[...]]> que contiene el texto especificado. |
WriteCDataAsync(String) |
Escribe asincrónicamente un bloque <![CDATA[...]]> que contiene el texto especificado. |
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. |
WriteCharEntityAsync(Char) |
Impone asincrónicamente la generación de una entidad de caracteres para el valor de carácter Unicode especificado. |
WriteChars(Char[], Int32, Int32) |
Cuando se invalida en una clase derivada, escribe texto en un búfer cada vez. |
WriteCharsAsync(Char[], Int32, Int32) |
Escribe asincrónicamente texto en un búfer cada vez. |
WriteComment(String) |
Cuando se invalida en una clase derivada, escribe un comentario <!--...--> que contiene el texto especificado. |
WriteCommentAsync(String) |
De forma asincrónica escribe un comentario <!--...--> que contiene el texto especificado. |
WriteDocType(String, String, String, String) |
Cuando se invalida en una clase derivada, escribe la declaración DOCTYPE con el nombre y atributos opcionales especificados. |
WriteDocTypeAsync(String, String, String, String) |
Escribe asincrónicamente la declaración DOCTYPE con el nombre y los atributos opcionales especificados. |
WriteElementString(String, String) |
Escribe un elemento con el nombre local y el valor especificados. |
WriteElementString(String, String, String) |
Escribe un elemento con el nombre local especificado, el URI de espacio de nombres y el valor. |
WriteElementString(String, String, String, String) |
Escribe un elemento con el prefijo, nombre local, el URI de espacio de nombres y el valor especificados. |
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. |
WriteEndAttribute() |
Cuando se invalida en una clase derivada, cierra la llamada a WriteStartAttribute(String, String) anterior. |
WriteEndAttributeAsync() |
Cierra de forma asincrónica la llamada anterior al método WriteStartAttribute(String, String) . |
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. |
WriteEndDocumentAsync() |
Cierra asincrónicamente todos los elementos o atributos abiertos y coloca de nuevo el sistema de escritura en el estado de inicio. |
WriteEndElement() |
Cuando se invalida en una clase derivada, cierra un elemento y extrae el ámbito de espacio de nombres correspondiente. |
WriteEndElementAsync() |
Cierra asincrónicamente un elemento y extrae el correspondiente ámbito de espacio de nombres. |
WriteEntityRef(String) |
Cuando se invalida en una clase derivada, escribe una referencia a entidad de la siguiente forma: |
WriteEntityRefAsync(String) |
De forma asincrónica coloca una referencia de entidad en tipo como |
WriteFullEndElement() |
Cuando se invalida en una clase derivada, cierra un elemento y extrae el ámbito de espacio de nombres correspondiente. |
WriteFullEndElementAsync() |
Cierra asincrónicamente un elemento y extrae el correspondiente ámbito de espacio de nombres. |
WriteName(String) |
Cuando se reemplaza en una clase derivada, escribe el nombre especificado, asegurándose de que es un nombre válido según la recomendación W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name). |
WriteNameAsync(String) |
Escribe de forma asincrónica el nombre especificado, asegurándose de que es un nombre válido según la recomendación XML 1.0 de W3C (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name). |
WriteNmToken(String) |
Cuando se invalida en una clase derivada, escribe el nombre especificado, asegurándose de que es un NmToken válido según la recomendación W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name). |
WriteNmTokenAsync(String) |
Escribe de forma asincrónica el nombre especificado, asegurándose de que es un NmToken válido según la recomendación XML 1.0 de W3C (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. |
WriteNode(XPathNavigator, Boolean) |
Copia todo el contenido del objeto XPathNavigator en el sistema de escritura. La posición de XPathNavigator permanece inalterada. |
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. |
WriteNodeAsync(XPathNavigator, Boolean) |
De forma asincrónica copia todo el objeto de XPathNavigator al escritor. La posición de XPathNavigator permanece inalterada. |
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?>. |
WriteProcessingInstructionAsync(String, String) |
Escribe de forma asincrónica una instrucción de procesamiento con un espacio entre el nombre y el texto: <?nombre texto?>. |
WriteQualifiedName(String, String) |
Cuando se invalida en una clase derivada, escribe el nombre completo del espacio de nombres. Este método busca un prefijo que está en el ámbito del espacio de nombres especificado. |
WriteQualifiedNameAsync(String, String) |
Escribe asincrónicamente el nombre completo del espacio de nombres. Este método busca un prefijo que está en el ámbito del espacio de nombres especificado. |
WriteRaw(Char[], Int32, Int32) |
Cuando se invalida en una clase derivada, escribe marcado sin formato manualmente desde un búfer de caracteres. |
WriteRaw(String) |
Cuando se invalida en una clase derivada, escribe marcado sin formato manualmente desde una cadena. |
WriteRawAsync(Char[], Int32, Int32) |
Escribe asincrónicamente el marcado sin formato de un búfer de caracteres. |
WriteRawAsync(String) |
Escribe asincrónicamente el marcado sin formato de una cadena. |
WriteStartAttribute(String) |
Escribe el inicio de un atributo con el nombre local especificado. |
WriteStartAttribute(String, String) |
Escribe el inicio de un atributo con el URI de espacio de nombres y el nombre local especificados. |
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. |
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. |
WriteStartDocument() |
Cuando se invalida en una clase derivada, escribe la declaración XML con la versión "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. |
WriteStartDocumentAsync() |
Escribe asincrónicamente la declaración XML con la versión "1.0". |
WriteStartDocumentAsync(Boolean) |
Escribe asincrónicamente la declaración XML con la versión "1.0" así como el atributo independiente. |
WriteStartElement(String) |
Cuando se invalida en una clase derivada, escribe una etiqueta de apertura con el nombre local especificado. |
WriteStartElement(String, String) |
Cuando se invalida en una clase derivada, escribe la etiqueta de apertura especificada y la asocia al espacio de nombres especificado. |
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. |
WriteStartElementAsync(String, String, String) |
Escribe asincrónicamente la etiqueta de apertura especificada y la asocia al espacio de nombres y al prefijo especificados. |
WriteString(String) |
Cuando se invalida en una clase derivada, escribe el contenido de texto especificado. |
WriteStringAsync(String) |
Escribe asincrónicamente el contenido de texto dado. |
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. |
WriteSurrogateCharEntityAsync(Char, Char) |
Genera y escribe asincrónicamente la entidad de carácter suplente del par de caracteres suplentes. |
WriteValue(Boolean) |
Escribe un valor Boolean. |
WriteValue(DateTime) |
Escribe un valor DateTime. |
WriteValue(DateTimeOffset) |
Escribe un valor DateTimeOffset. |
WriteValue(Decimal) |
Escribe un valor Decimal. |
WriteValue(Double) |
Escribe un valor Double. |
WriteValue(Int32) |
Escribe un valor Int32. |
WriteValue(Int64) |
Escribe un valor Int64. |
WriteValue(Object) |
Escribe el valor del objeto. |
WriteValue(Single) |
Escribe un número de punto flotante de precisión sencilla. |
WriteValue(String) |
Escribe un valor String. |
WriteWhitespace(String) |
Cuando se invalida en una clase derivada, escribe el espacio en blanco especificado. |
WriteWhitespaceAsync(String) |
Escribe asincrónicamente el espacio en blanco especificado. |
Implementaciones de interfaz explícitas
IDisposable.Dispose() |
Para obtener una descripción de este miembro, vea Dispose(). |
Métodos de extensión
ConfigureAwait(IAsyncDisposable, Boolean) |
Configura la forma en la que se realizan las expresiones await en las tareas devueltas desde un elemento asincrónico descartable. |
Se aplica a
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta:Enviar y ver comentarios de