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