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 の範囲内にある必要があります。
例外
無効なサロゲート文字ペアが渡されました。
注釈
注意
.NET Framework 2.0 以降では、新しい機能を利用するために、メソッドとXmlWriterSettingsクラスをXmlWriter.Create使用してインスタンスを作成XmlWriterすることをお勧めします。
この方法は、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 を参照してください。