XmlTextWriter.WriteCharEntity(Char) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した Unicode 文字値の文字エンティティを強制的に生成します。
public:
override void WriteCharEntity(char ch);public override void WriteCharEntity (char ch);override this.WriteCharEntity : char -> unitPublic Overrides Sub WriteCharEntity (ch As Char)パラメーター
- ch
- Char
文字エンティティを生成する対象の Unicode 文字。
例外
文字がサロゲート ペアの文字範囲、つまり 0xd800 - 0xdfff内にあります。これ以外の場合、テキストは非整形式の XML ドキュメントになります。
WriteState が Closed です。
例
次の例では、このメソッドを 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
注釈
注意
.NET Framework 2.0 以降では、新しい機能を利用するために、メソッドとXmlWriterSettingsクラスをXmlWriter.Create使用してインスタンスを作成XmlWriterすることをお勧めします。
このメソッドは、Unicode 文字を 16 進数の文字エンティティ参照形式で書き込みます。