XmlTextWriter.WriteCharEntity(Char) Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlTextWriter.cs

Belirtilen Unicode karakter değeri için karakter varlığının oluşturulmasını zorlar.

public:
 override void WriteCharEntity(char ch);

public override void WriteCharEntity(char ch);

override this.WriteCharEntity : char -> unit

Public Overrides Sub WriteCharEntity (ch As Char)

Parametreler

ch

Char

Karakter varlığı oluşturulacak Unicode karakteri.

Özel durumlar

ArgumentException

Karakter vekil çift karakter aralığındadır 0xd800 - 0xdfff; aksi halde metin düzgün biçimlendirilmemiş bir XML belgesiyle sonuçlanır.

InvalidOperationException

WriteState şudur: Closed.

Örnekler

Aşağıdaki örnek, bir e-posta adresi yazmak için yöntemini kullanır WriteCharEntity .

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

Açıklamalar

Note

XmlWriter öneririz ki, yeni işlevlerden yararlanmak için XmlWriter.Create yöntemi ve XmlWriterSettings sınıfını kullanarak örnekler oluşturun.

Bu yöntem Unicode karakterini onaltılık karakter varlık başvuru biçiminde yazar.