XmlWriter.WriteString(String) Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Source:

XmlWriter.cs

En cas de substitution dans une classe dérivée, écrit le texte spécifié.

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)

Paramètres

text

String

Texte à écrire.

Exceptions

ArgumentException

La chaîne de texte contient une paire de substitution non valide.

InvalidOperationException

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Exemples

L’exemple suivant écrit un nœud 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

Remarques

WriteString effectue les actions suivantes :

• Les caractères &, <et > sont remplacés par &, <et >, respectivement.

• Le comportement par défaut d’une XmlWriter utilisation Create créée consiste à lever un lors de la tentative d’écriture ArgumentException de valeurs de caractères dans la plage 0x-0x1F (à l’exclusion des espaces blancs 0x9, 0xA et 0xD). Ces caractères XML non valides peuvent être écrits en créant le XmlWriter avec la CheckCharacters propriété définie sur false. Cela entraîne le remplacement des caractères par des entités de caractères numériques (� via �x1F). En outre, un XmlTextWriter créé avec l’opérateur new remplace les caractères non valides par des entités de caractères numériques par défaut.

Note Microsoft n’encourage pas la pratique d’écrire des caractères XML non valides, car de nombreuses applications qui consomment du code XML ne sont pas conçues pour gérer des caractères non valides.

• Si WriteString est appelé dans le contexte d’une valeur d’attribut, les guillemets doubles et simples sont respectivement remplacés par " et ' .

Par exemple, cette chaîne test<item>test d’entrée est écrite en tant que

test<item>test

Si text est null ou String.Empty, cette méthode écrit un nœud de texte sans contenu de données.

Pour obtenir la version asynchrone de cette méthode, consultez WriteStringAsync.