XmlWriter.WriteSurrogateCharEntity メソッド

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

XmlWriter.WriteSurrogateCharEntity メソッド

派生クラスでオーバーライドされると、サロゲート文字ペアのサロゲート文字エンティティを生成し、書き込みます。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As XmlWriter
Dim lowChar As Char
Dim highChar As Char

instance.WriteSurrogateCharEntity(lowChar, highChar)

C#

public abstract void WriteSurrogateCharEntity
 (
    char lowChar,
    char highChar
)

C++

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

J#

public abstract void WriteSurrogateCharEntity
 (
    char lowChar, 
    char highChar
)

JScript

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

パラメータ

lowChar

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

highChar

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

例外

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

解説

このメソッドは、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

参照

関連項目
XmlWriter クラス
XmlWriter メンバ
System.Xml 名前空間
その他の技術情報
XmlWriter による XML の書き方