XmlTextWriter.WriteSurrogateCharEntity メソッド

.NET Framework クラス ライブラリ リファレンス

XmlTextWriter.WriteSurrogateCharEntity メソッド

サロゲート文字ペアのサロゲート文字エンティティを生成し、書き込みます。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Overrides Sub WriteSurrogateCharEntity
 ( _
    lowChar As Char, _
    highChar As Char _
)

Visual Basic (使用法)

Dim instance As XmlTextWriter
Dim lowChar As Char
Dim highChar As Char

instance.WriteSurrogateCharEntity(lowChar, highChar)

C#

public override void WriteSurrogateCharEntity
 (
    char lowChar,
    char highChar
)

C++

public:
virtual void WriteSurrogateCharEntity (
    wchar_t lowChar, 
    wchar_t highChar
) override

J#

public void WriteSurrogateCharEntity (
    char lowChar, 
    char highChar
)

JScript

public override function WriteSurrogateCharEntity
 (
    lowChar : char, 
    highChar : char
)

パラメータ

lowChar

下位サロゲート。この値は、0xDC00 から 0xDFFF の範囲内にある必要があります。

highChar

上位サロゲート。この値は、0xD800 から 0xDBFF の範囲内にある必要があります。

例外

例外の種類	条件
Exception	無効なサロゲート文字ペアが渡されました。

解説

メモ
Microsoft .NET Framework version 2.0 リリースでは、System.Xml.XmlWriter.Create メソッドと XmlWriterSettings クラスを使用して XmlWriter インスタンスを作成することをお勧めします。これにより、このリリースで導入されたすべての新機能を十分に活用できます。詳細については、「XML ライタの作成」を参照してください。

このメソッドは、UTF-16 エンコーディングを使用するシステムだけに適用されます。

サロゲート文字エンティティは、16 進形式で書き込まれます。サロゲート文字は、#x10000 から #x10FFFF の範囲内にあります。サロゲート文字エンティティを生成するには、(highChar - 0xD800) * 0x400 + (lowChar - 0xDC00) + 0x10000 の数式を使用します。

HTML と XML の両方とも、ドキュメントの文字セット (つまり、数字参照の表記) は UCS [ISO-10646] に基づいています。したがって、ソース ドキュメントの単一の数字参照は、文字列の 2 つの 16 ビット単位 (上位サロゲートと下位サロゲート) に対応する場合があります。これらの 16 ビット単位は、サロゲート ペアとして参照されます。

サロゲートまたは文字の詳細については、http://www.unicode.org にある『Unicode 3.0/Unicode 2.0 standard』のセクション 3.7 または、http://www.w3.org/TR/REC-xml#charsets にある W3C 勧告『XML 1.0』のセクション 2.2 を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlTextWriter クラス
XmlTextWriter メンバ
System.Xml 名前空間