XmlTextWriter.WriteString(String) Metodo

Definizione

Scrive il contenuto di testo specificato.

public override void WriteString (string? text);
public override void WriteString (string text);

Parametri

text
String

Testo da scrivere.

Eccezioni

La stringa di testo contiene una coppia di surrogati non valida.

Esempio

Nell'esempio seguente viene scritto un frammento 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.
     XmlTextWriter writer = null;
     writer = new XmlTextWriter (Console.Out);

     //Use indentation for readability.
     writer.Formatting = Formatting.Indented;
     writer.Indentation = 4;

     //Write an element (this one is the root).
     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 to file and close the writer.
     writer.Close();
  }
}

Commenti

Nota

A partire dalla .NET Framework 2.0, è consigliabile creare XmlWriter istanze usando il metodo e la XmlWriter.Create XmlWriterSettings classe per sfruttare le nuove funzionalità.

WriteString esegue le operazioni seguenti

  • I caratteri &, <e > vengono sostituiti rispettivamente con &amp;, &lt;e , &gt;.

  • I valori di carattere nell'intervallo 0x-0x1F (esclusi gli spazi vuoti 0x9, 0xA e 0xD) vengono sostituiti con entità di caratteri numerici (&#0; tramite &#0x1F).

  • Se WriteString viene chiamato nel contesto di un valore dell'attributo, le virgolette doppie e singole vengono sostituite rispettivamente con &quot; e &apos; .

Ad esempio, questa stringa test<item>test di input viene scritta come test&lt;item&gt;test.

Se text è null o String.Empty, questo metodo scrive un nodo di testo senza contenuto dati.

Si applica a