XmlTextWriter.WriteCharEntity(Char) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlTextWriter.cs

Memaksa pembuatan entitas karakter untuk nilai karakter Unicode yang ditentukan.

public:
 override void WriteCharEntity(char ch);

public override void WriteCharEntity(char ch);

override this.WriteCharEntity : char -> unit

Public Overrides Sub WriteCharEntity (ch As Char)

Parameter

ch

Char

Karakter Unicode untuk menghasilkan entitas karakter.

Pengecualian

ArgumentException

Karakter berada dalam rentang karakter pasangan pengganti, 0xd800 - 0xdfff; atau teks akan menghasilkan dokumen XML yang tidak terbentuk dengan baik.

InvalidOperationException

WriteState adalah Closed.

Contoh

Contoh berikut menggunakan WriteCharEntity metode untuk menulis alamat email.

using System;
using System.Xml;

public class Sample {

  public static void Main() {

    XmlTextWriter writer = null;

      try {

        writer = new XmlTextWriter (Console.Out);

        // Write an element.
        writer.WriteStartElement("address");

        // Write an email address using entities
        // for the @ and . characters.
        writer.WriteString("someone");
        writer.WriteCharEntity('@');
        writer.WriteString("example");
        writer.WriteCharEntity('.');
        writer.WriteString("com");
        writer.WriteEndElement();
    }

    finally {
      // Close the writer.
      if (writer != null)
        writer.Close();
    }
  }
}

Imports System.Xml

Public Class Sample 
 
    Public Shared Sub Main() 
   
        Dim writer As XmlTextWriter = Nothing

        Try 

            writer = new XmlTextWriter(Console.Out)

            ' Write an element.
            writer.WriteStartElement("address")
     
            ' Write an email address using entities
            ' for the @ and . characters.
            writer.WriteString("someone")
            writer.WriteCharEntity("@"c)
            writer.WriteString("example")
            writer.WriteCharEntity("."c)
            writer.WriteString("com")
            writer.WriteEndElement()        
 
        Finally
            ' Close the writer.
            If writer IsNot Nothing
                writer.Close()
            End If
        End Try

    End Sub
End Class

Keterangan

Note

Kami menyarankan agar Anda membuat XmlWriter instans dengan menggunakan XmlWriter.Create metode dan XmlWriterSettings kelas untuk memanfaatkan fungsionalitas baru.

Metode ini menulis karakter Unicode dalam format referensi entitas karakter heksadesimal.