XmlWriter.WriteString(String) Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Source:

XmlWriter.cs

Cuando se invalida 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ó un método XmlWriter antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.

Ejemplos

En el ejemplo siguiente se escribe un nodo XML.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   // Create a writer to write XML to the console.
   XmlWriterSettings^ settings = gcnew XmlWriterSettings;
   settings->Indent = true;
   settings->OmitXmlDeclaration = true;
   XmlWriter^ writer = XmlWriter::Create( Console::Out, settings );
   
   // Write the book element.
   writer->WriteStartElement( L"book" );
   
   // Write the title element.
   writer->WriteStartElement( L"title" );
   writer->WriteString( L"Pride And Prejudice" );
   writer->WriteEndElement();
   
   // Write the close tag for the root element.
   writer->WriteEndElement();
   
   // Write the XML and close the writer.
   writer->Close();
   return 1;
}

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 objeto creado mediante Create 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 en false. Si lo hace, se reemplazarán los caracteres por entidades de caracteres numéricos (� a �x1F). Además, un XmlTextWriter objeto creado con el new operador reemplazará los caracteres no válidos por entidades de caracteres numéricos de forma predeterminada.

Nota Microsoft no recomienda 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 o nullString.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.