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

Определение

Когда переопределено в производном классе, создает и записывает сущность символа-заместителя для пары символов-заместителей.

public:
 abstract void WriteSurrogateCharEntity(char lowChar, char highChar);
public abstract void WriteSurrogateCharEntity (char lowChar, char highChar);
abstract member WriteSurrogateCharEntity : char * char -> unit
Public MustOverride Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)

Параметры

lowChar
Char

Младший заместитель. Значение должно быть в диапазоне от 0xDC00 до 0xDFFF.

highChar
Char

Старший заместитель. Значение должно быть в диапазоне от 0xD800 до 0xDBFF.

Исключения

Передана недопустимая пара символов-заместителей.

Метод XmlWriter вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".

Комментарии

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

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

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

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

Асинхронная версия этого метода см. в разделе WriteSurrogateCharEntityAsync.

Применяется к