XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Метод

Определение

Пространство имен:

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Исходный код:

XmlTextWriter.cs

Создает и записывает суррогатную сущность символа для суррогатной пары символов.

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

Была передана недопустимая суррогатная пара символов.

Комментарии

Note

Рекомендуется создавать XmlWriter экземпляры с помощью XmlWriter.Create метода и XmlWriterSettings класса, чтобы воспользоваться преимуществами новых функций.

Этот метод применим только к системам, использующим кодировку UTF-16.

Суррогатная сущность символа написана в шестнадцатеричном формате. Диапазон суррогатных символов — #x10000 это #x10FFFF. Следующая формула используется для создания суррогатной символьной сущности: (highChar - 0xD800) * + 0x400 (lowChar - 0xDC00) + . 0x10000

Для HTML и XML набор символов документа (и поэтому нотация числовых ссылок на символы) основана на UCS [ISO-10646]. Одна числовая ссылка на символ в исходном документе может в некоторых случаях соответствовать двум 16-разрядным единицам в строке (высокая суррогатная и низкая суррогатная). Эти 16-разрядные единицы называются суррогатной парой.

Дополнительные сведения о суррогатах или символах см. в разделе 3.7 стандарта Юникод 3.0/Юникод 2.0 или раздел 2.2 рекомендации W3C XML 1.0.