XmlWriter.WriteString(String) Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlWriter.cs

Ha felül van bírálva egy származtatott osztályban, megírja a megadott szöveges tartalmat.

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éterek

text

String

Az írandó szöveg.

Kivételek

ArgumentException

A szöveges sztring érvénytelen helyettesítő párt tartalmaz.

InvalidOperationException

Egy XmlWriter metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

Példák

Az alábbi példa egy XML-csomópontot ír.

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

Megjegyzések

WriteString a következőket teszi:

• A karakterek &, <és > helyébe &a , <és >, illetve.

• A létrehozott XmlWriter karakterek alapértelmezett viselkedése Create az, ha ArgumentException a 0x-0x1F tartományban próbál karakterértékeket írni (kivéve a szóköz karaktereket 0x9, 0xA és 0xD). Ezek az érvénytelen XML-karakterek a tulajdonság beállításával XmlWriterCheckCharactersírhatókfalse. Ez azt eredményezi, hogy a karaktereket numerikus karakterentitások (� és �x1F) váltják fel. Emellett XmlTextWriter az new operátorral létrehozott karakterek alapértelmezés szerint numerikus karakterentitásokra cserélik az érvénytelen karaktereket.

Note Microsoft nem ösztönzi az érvénytelen XML-karakterek írásának gyakorlatát, mivel az XML-t használó alkalmazások többsége nem alkalmas érvénytelen karakterek kezelésére.

• Ha WriteString egy attribútumérték kontextusában van meghívva, a kettős és az egyszeri idézőjelek helyébe " a kettős és ' az egyszeres idézőjelek kerülnek.

Ez a bemeneti sztring test<item>test például a következőként van megírva:

test<item>test

Ha text az vagy nullString.Empty, akkor ez a metódus adattartalom nélkül ír egy szöveges csomópontot.

A metódus aszinkron verziójáról lásd WriteStringAsync: .