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

Определение

Когда переопределено в производном классе, создает и записывает сущность символа-заместителя для пары символов-заместителей.When overridden in a derived class, generates and writes the surrogate character entity for the surrogate character pair.

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

Младший заместитель.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.

Метод XmlWriter вызван перед завершением предыдущей асинхронной операции.An XmlWriter method was called before a previous asynchronous operation finished. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Комментарии

Этот метод применим только в системах, использующих кодировку UTF-16.This method is only applicable on systems that use UTF-16 encoding.

Сущность суррогатных символов записывается в шестнадцатеричном формате.The surrogate character entity is written in hexadecimal format. Диапазон для суррогатных символов #x10000 для #x10FFFF.The range for surrogate characters is #x10000 to #x10FFFF. Следующая формула используется для создания сущности суррогатных символов: ( highChar -0xD800) * 0x400 + ( lowChar -0xDC00) + 0x10000The 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]. В некоторых случаях ссылка на отдельный числовой символ в исходном документе может соответствовать 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.

Дополнительные сведения о суррогатах или символах см. в разделе 3,7 стандарта Юникод 3.0/Unicode 2,0, расположенном по адресу https://www.unicode.org , или в разделе 2,2 рекомендации консорциума W3C XML 1,0.For more information regarding surrogates or characters, refer to section 3.7 of the Unicode 3.0/Unicode 2.0 standard located at https://www.unicode.org, or section 2.2 of the W3C XML 1.0 Recommendation.

Асинхронную версию этого метода см. в разделе WriteSurrogateCharEntityAsync .For the asynchronous version of this method, see WriteSurrogateCharEntityAsync.

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