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

Определение

Пространство имен:
System.Xml
Сборки:
System.Xml.dll, System.Xml.ReaderWriter.dll
Сборки:
netstandard.dll, System.Xml.ReaderWriter.dll
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs
Исходный код:
XmlWriter.cs

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

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.

Исключения

ArgumentException

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

InvalidOperationException

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

Комментарии

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

Суррогатная сущность символа написана в шестнадцатеричном формате. Диапазон суррогатных символов #x10000 #x10FFFF. Следующая формула используется для создания суррогатной символьной сущности: ( -0xD800) * 0x400 + (highCharlowChar -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.

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