XmlWriter.WriteSurrogateCharEntity(Char, Char) メソッド

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

アセンブリ:

System.Xml.dll

アセンブリ:

netstandard.dll

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

public:
 abstract void WriteSurrogateCharEntity(char lowChar, char highChar);

public abstract void WriteSurrogateCharEntity (char lowChar, char highChar);

abstract member WriteSurrogateCharEntity : char * char -> unit

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

パラメーター

lowChar

Char

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

highChar

Char

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

例外

ArgumentException

無効なサロゲート文字ペアが渡されました。

InvalidOperationException

先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

注釈

この方法は、UTF-16 エンコードを使用するシステムにのみ適用されます。

サロゲート文字エンティティは、16 進形式で記述されます。 サロゲート文字の範囲は、#x10FFFFに#x10000。 サロゲート文字エンティティを生成するには、次の式を使用します。 (highChar -0xD800) * 0x400 + (lowChar -0xDC00) + 0x10000

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

サロゲートまたは文字の詳細については、W3C XML 1.0 推奨事項のセクション 2.2 にある Unicode 3.0/Unicode 2.0 標準https://www.unicode.orgのセクション 3.7 を参照してください。

このメソッドの非同期バージョンについては、次を参照してください WriteSurrogateCharEntityAsync。