XmlTextWriter.WriteCharEntity(Char) Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:

System.Xml.dll

Bütünleştirilmiş Kod:

netstandard.dll

Belirtilen Unicode karakter değeri için bir 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 belgesine neden olur.

InvalidOperationException

, WriteState şeklindedir Closed.

Örnekler

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

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   XmlTextWriter^ writer = nullptr;
   try
   {
      writer = gcnew 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 != nullptr )
            writer->Close();
   }

}

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

Not

.NET Framework 2.0'dan başlayarak, yeni işlevlerden yararlanmak için yöntemini ve XmlWriterSettings sınıfını XmlWriter.Create kullanarak örnekler oluşturmanızı XmlWriter öneririz.

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