XmlTextWriter.WriteString(String) Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlTextWriter.cs

A megadott szöveges tartalmat írja.

public:
 override void WriteString(System::String ^ text);

public override void WriteString(string? text);

override this.WriteString : string -> unit

Public Overrides Sub WriteString (text As String)

Paraméterek

text

String

Írandó szöveg.

Kivételek

ArgumentException

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

Példák

Az alábbi példa egy XML-töredéket í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.
     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();
  }
}

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 writer As XmlTextWriter = Nothing
        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()
    End Sub
End Class

Megjegyzések

Note

Javasoljuk, hogy a XmlWriter metódus és a XmlWriter.Create osztály használatával hozzon létre XmlWriterSettings példányokat az új funkciók előnyeinek kihasználásához.

WriteString a következőket teszi:

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

• A 0x-0x1F tartományban lévő karakterértékek (a szóköz karakterek kivételével 0x9, 0xA és 0xD) numerikus karakterentitásokra (� a függvényen keresztül &#0x1F) lépnek.

• 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éppen íródott test<item>test: .

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