XmlTextWriter.WriteCharEntity メソッド

指定した Unicode 文字値の文字エンティティを強制的に生成します。

Overrides Public Sub WriteCharEntity( _
   ByVal ch As Char _)
[C#]
public override void WriteCharEntity(charch);
[C++]
public: void WriteCharEntity(__wchar_tch);
[JScript]
public override function WriteCharEntity(
   ch : Char);

パラメータ

• ch
  文字エンティティを生成する対象の Unicode 文字。

例外

例外の種類	条件
ArgumentException	文字がサロゲート ペアの文字範囲、つまり 0xd800- 0xdfff 内にあります。この範囲内にない場合、テキストは非整形式の XML ドキュメントになります。
InvalidOperationException	WriteState が Closed です。

解説

このメソッドは、Unicode 文字を 16 進文字エンティティの参照形式で書き込みます。

使用例

[Visual Basic, C#, C++] WriteCharEntity メソッドを使用して、電子メール アドレスを書き込む例を次に示します。

 
Imports System
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 e-mail 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 not writer is nothing
        writer.Close()
      end if
    end try 

  end sub
end class

[C#] 
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 e-mail 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();
    } 
  }
}

[C++] 
#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::Xml;

int main() {

   XmlTextWriter* writer = 0;

   try {

      writer = new XmlTextWriter (Console::Out);

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

      // Write an e-mail address using entities
      // for the @ and . characters.
      writer->WriteString(S"someone");
      writer->WriteCharEntity('@');
      writer->WriteString(S"example");
      writer->WriteCharEntity('.');
      writer->WriteString(S"com");
      writer->WriteEndElement();

   }        

   __finally {
      // Close the writer.
      if (writer != 0)
         writer->Close();
   } 
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

XmlTextWriter クラス | XmlTextWriter メンバ | System.Xml 名前空間