Metodo XmlWriter.WriteString

WriteString esegue le operazioni seguenti:

• I caratteri &, < e > vengono sostituti rispettivamente da &amp;, &lt; e &gt;.

• Il comportamento predefinito di un oggetto XmlWriter creato tramite Create prevede la generazione di un'eccezione ArgumentException quando si tenta di scrivere i valori dei caratteri compresi tra 0x e 0x1F esclusi gli spazi vuoti 0x9, 0xA e 0xD. Questi caratteri XML non validi possono essere scritti creando l'oggetto XmlWriter con la proprietà CheckCharacters impostata su false. In questo modo i caratteri verranno sostituiti da entità di caratteri numerici (da &#0 a &#0x1F). Inoltre, per impostazione predefinita, un oggetto XmlTextWriter creato con l'operatore new sostituirà i caratteri non validi con entità di caratteri numerici.

Nota   Microsoft sconsiglia di scrivere caratteri XML non validi, poiché molte applicazioni che utilizzano XML non sono progettate per gestire caratteri non validi.

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

La stringa di input test<item>test viene, ad esempio, scritta nel seguente modo:

 test<item>test

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

Per la versione asincrona di questo metodo, vedere WriteStringAsync.

Nell'esempio riportato di seguito viene scritto 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();  

  }
}

.NET Framework

.NET Framework Client Profile

Libreria di classi portabile

.NET per applicazioni Windows Store

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

Riferimenti

Altre risorse