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

定義

サロゲート文字ペアのサロゲート文字エンティティを生成し、書き込みます。Generates and writes the surrogate character entity for the surrogate character pair.

public:
 override void WriteSurrogateCharEntity(char lowChar, char highChar);
public override void WriteSurrogateCharEntity (char lowChar, char highChar);
override this.WriteSurrogateCharEntity : char * char -> unit
Public Overrides Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)

パラメーター

lowChar
Char

下位サロゲート。The low surrogate. この値は、0xDC00 から 0xDFFF の範囲内にある必要があります。This must be a value between 0xDC00 and 0xDFFF.

highChar
Char

上位サロゲート。The high surrogate. この値は、0xD800 から 0xDBFF の範囲内にある必要があります。This must be a value between 0xD800 and 0xDBFF.

例外

無効なサロゲート文字ペアが渡されました。An invalid surrogate character pair was passed.

注釈

注意

.NET Framework 2.0 以降では、新しい機能を利用するXmlWriterために、 XmlWriter.CreateメソッドとXmlWriterSettingsクラスを使用してインスタンスを作成することをお勧めします。Starting with the .NET Framework 2.0, we recommend that you create XmlWriter instances by using the XmlWriter.Create method and the XmlWriterSettings class to take advantage of new functionality.

このメソッドは、UTF-16 エンコードを使用するシステムにのみ適用されます。This method is only applicable on systems that use UTF-16 encoding.

サロゲート文字エンティティは16進形式で記述されます。The surrogate character entity is written in hexadecimal format. サロゲート文字の範囲は#x10000 、に#x10FFFFなります。The range for surrogate characters is #x10000 to #x10FFFF. 次の式は、サロゲート文字エンティティを生成するためにhighChar使用さ0x400れますlowChar: ( 0x10000 - 0xD800) * + ( - 0xDC00) +。The following formula is used to generate the surrogate character entity: (highChar - 0xD800) * 0x400 + (lowChar - 0xDC00) + 0x10000.

HTML と XML の両方で、ドキュメントの文字セット (および数値の文字参照の表記) は UCS [ISO-10646] に基づいています。For both HTML and XML, the document character set (and therefore the notation of numeric character references) is based on UCS [ISO-10646]. したがって、ソースドキュメント内の1つの数値文字参照は、文字列の 2 16 ビット単位に対応する場合があります (上位サロゲートと下位サロゲート)。A single numeric character reference in a source document may therefore in some cases correspond to two 16-bit units in a string (a high surrogate and a low surrogate). これらの16ビットユニットは、サロゲートペアと呼ばれます。These 16-bit units are referred to as a surrogate pair.

サロゲートまたは文字の詳細については、 unicode 3.0/unicode 2.0 標準のセクション3.7 を参照するか、W3C 勧告『 XML 1.0 』のセクション 2.2を参照してください。For more information regarding surrogates or characters, refer to section 3.7 of the Unicode 3.0/Unicode 2.0 standard, or section 2.2 of the W3C XML 1.0 Recommendation.

適用対象