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

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

アセンブリ:

System.Xml.dll

アセンブリ:

netstandard.dll

サロゲート文字ペアのサロゲート文字エンティティを生成し、書き込みます。

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

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

highChar

Char

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

例外

Exception

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

注釈

注意

.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 を参照してください。