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

Определение

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

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.

Исключения

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

Комментарии

Примечание

Начиная с версии платформа .NET Framework 2.0 рекомендуется создавать 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.

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