XmlWriter.WriteSurrogateCharEntity(Char, Char) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
派生クラスでオーバーライドされると、サロゲート文字ペアのサロゲート文字エンティティを生成して書き込みます。
public:
abstract void WriteSurrogateCharEntity(char lowChar, char highChar);public abstract void WriteSurrogateCharEntity(char lowChar, char highChar);abstract member WriteSurrogateCharEntity : char * char -> unitPublic MustOverride Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)パラメーター
- lowChar
- Char
低サロゲート。 これは、0xDC00と0xDFFFの間の値である必要があります。
- highChar
- Char
上位サロゲート。 これは、0xD800と0xDBFFの間の値である必要があります。
例外
無効なサロゲート文字ペアが渡されました。
前の非同期操作が完了する前に、 XmlWriter メソッドが呼び出されました。 この場合、"非同期操作は既に進行中です" というメッセージで InvalidOperationException がスローされます。
注釈
この方法は、UTF-16 エンコードを使用するシステムにのみ適用されます。
サロゲート文字エンティティは、16 進形式で記述されます。 サロゲート文字の範囲は、#x10FFFF に #x10000。 代理文字エンティティを生成するには、次の式を使用します。 (highChar -0xD800) * 0x400 + (lowChar -0xDC00) + 0x10000
HTML と XML の両方で、ドキュメント文字セット (したがって数値参照の表記) は UCS [ISO-10646] に基づいています。 したがって、ソース ドキュメント内の 1 つの数値参照は、文字列内の 2 つの 16 ビット単位 (高サロゲートと低サロゲート) に対応する場合があります。 これらの 16 ビット単位はサロゲート ペアと呼ばれます。
サロゲートまたは文字の詳細については、 https://www.unicode.orgにある Unicode 3.0/Unicode 2.0 標準のセクション 3.7、または W3C XML 1.0 Recommendation のセクション 2.2 を参照してください。
このメソッドの非同期バージョンについては、 WriteSurrogateCharEntityAsyncを参照してください。
