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.