XmlWriter.WriteString(String) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

System.Xml.ReaderWriter.dll

Sumber:

XmlWriter.cs

Saat ditimpa di kelas turunan, tulis konten teks yang diberikan.

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)

Parameter

text

String

Teks yang akan ditulis.

Pengecualian

ArgumentException

String teks berisi pasangan pengganti yang tidak valid.

InvalidOperationException

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Contoh

Contoh berikut menulis simpul 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

Keterangan

WriteString melakukan hal berikut:

• &Karakter , <, dan > masing-masing diganti dengan &, , dan .><

• Perilaku default yang XmlWriter dibuat menggunakan Create adalah melempar ArgumentException saat mencoba menulis nilai karakter dalam rentang 0x-0x1F (tidak termasuk karakter spasi putih 0x9, 0xA, dan 0xD). Karakter XML yang tidak valid ini dapat ditulis dengan membuat XmlWriter dengan properti yang CheckCharacters diatur ke false. Melakukannya akan mengakibatkan karakter diganti dengan entitas karakter numerik (� melalui �x1F). Selain itu, yang XmlTextWriter dibuat dengan new operator akan menggantikan karakter yang tidak valid dengan entitas karakter numerik secara default.

Catatan Microsoft tidak mendorong praktik penulisan karakter XML yang tidak valid karena banyak aplikasi yang menggunakan XML tidak dirancang untuk menangani karakter yang tidak valid.

• Jika WriteString dipanggil dalam konteks nilai atribut, tanda kutip ganda dan tunggal masing-masing diganti dengan " dan ' .

Misalnya, string test<item>test input ini ditulis sebagai

test<item>test

Jika text adalah null atau String.Empty, metode ini menulis simpul teks tanpa konten data.

Untuk versi asinkron metode ini, lihat WriteStringAsync.