XmlWriter.WriteString(String) Método

Definición

Espacio de nombres:

System.Xml

Ensamblados:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlWriter.cs

Cuando se reemplaza en una clase derivada, escribe el contenido de texto especificado.

public:
 abstract void WriteString(System::String ^ text);

public abstract void WriteString(string? text);

abstract member WriteString : string -> unit

Public MustOverride Sub WriteString (text As String)

Parámetros

text

String

Texto que se va a escribir.

Excepciones

ArgumentException

La cadena de texto contiene un par suplente no válido.

InvalidOperationException

Se llamó a un XmlWriter método antes de que finalice una operación asincrónica anterior. En este caso, InvalidOperationException se produce con el mensaje "Una operación asincrónica ya está en curso".

Ejemplos

En el ejemplo siguiente se escribe un nodo XML.

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

     // Create a writer to write XML to the console.
     XmlWriterSettings settings = new XmlWriterSettings();
     settings.Indent = true;
     settings.OmitXmlDeclaration = true;
     XmlWriter writer = XmlWriter.Create(Console.Out, settings);

     // Write the book element.
     writer.WriteStartElement("book");

     // Write the title element.
     writer.WriteStartElement("title");
     writer.WriteString("Pride And Prejudice");
     writer.WriteEndElement();

     // Write the close tag for the root element.
     writer.WriteEndElement();

     // Write the XML and close the writer.
     writer.Close();
  }
}

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
  Public Shared Sub Main()

     ' Create a writer to write XML to the console.
     Dim settings As XmlWriterSettings = new XmlWriterSettings()
     settings.Indent = true
     settings.OmitXmlDeclaration = true
     Dim writer As XmlWriter = XmlWriter.Create(Console.Out, settings)

     ' Write the book element.
     writer.WriteStartElement("book")
        
     ' Write the title element.
     writer.WriteStartElement("title")
     writer.WriteString("Pride And Prejudice")
     writer.WriteEndElement()
        
     ' Write the close tag for the root element.
     writer.WriteEndElement()
        
     ' Write the XML and close the writer.
     writer.Close()

  End Sub
End Class

Comentarios

WriteString hace lo siguiente:

• Los caracteres &, <y > se reemplazan por &, <y >, respectivamente.

• El comportamiento predeterminado de un XmlWriter uso Create creado es iniciar un ArgumentException al intentar escribir valores de caracteres en el intervalo 0x-0x1F (excepto los caracteres de espacio en blanco 0x9, 0xA y 0xD). Estos caracteres XML no válidos se pueden escribir creando con XmlWriter la CheckCharacters propiedad establecida falseen . Si lo hace, se reemplazarán los caracteres por entidades de caracteres numéricos (� a �x1F). Además, un XmlTextWriter creado con el new operador reemplazará los caracteres no válidos por entidades de caracteres numéricos de forma predeterminada.

Nota Microsoft no fomenta la práctica de escribir caracteres XML no válidos, ya que muchas aplicaciones que consumen XML no están diseñadas para controlar caracteres no válidos.

• Si WriteString se llama a en el contexto de un valor de atributo, las comillas dobles y simples se reemplazan por " y ' respectivamente.

Por ejemplo, esta cadena test<item>test de entrada se escribe como

test<item>test

Si text es null o String.Empty, este método escribe un nodo de texto sin contenido de datos.

Para obtener la versión asincrónica de este método, vea WriteStringAsync.