IContentHandler.Characters(Char[], Int32, Int32) Метод

Ссылка

Определение

Пространство имен:: Org.Xml.Sax

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Получение уведомления о символьных данных.

[Android.Runtime.Register("characters", "([CII)V", "GetCharacters_arrayCIIHandler:Org.Xml.Sax.IContentHandlerInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public void Characters (char[]? ch, int start, int length);

[<Android.Runtime.Register("characters", "([CII)V", "GetCharacters_arrayCIIHandler:Org.Xml.Sax.IContentHandlerInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member Characters : char[] * int * int -> unit

Параметры

ch: Char[]

символы из XML-документа

start: Int32

начальная позиция в массиве

length: Int32

число символов для чтения из массива

Атрибуты: RegisterAttribute

Исключения

SAXException

любое исключение SAX, возможно, обтекание другим исключением

Средство синтаксического анализа вызовет этот метод, чтобы сообщить о каждом фрагменте символьных данных. Средства синтаксического анализа SAX могут возвращать все смежные символьные данные в одном блоке или разделить их на несколько блоков; однако все символы в одном событии должны поступать из одной внешней сущности, чтобы указатель предоставлял полезную информацию.

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

Отдельные символы могут состоять из нескольких значений Java char . Существует два важных случая, когда это происходит, потому что символы не могут быть представлены всего в шестнадцати битах. В одном случае символы представлены в эм-суррогатной <>паре</em> с помощью двух специальных значений Юникода. Такие символы находятся в так называемых "астральных плоскостях" с точкой кода над U+FFFF. Второй случай включает составные символы, такие как базовый символ, сочетающийся с одним или несколькими символами акцента.

Код не должен предполагать, что алгоритмы, использующие charидиомы во время, будут работать в единицах символов. В некоторых случаях они будут разделены символами. Это важно, когда XML разрешает произвольные символы, такие как значения атрибутов, данные инструкции и комментарии, а также данные, полученные из этого метода. Это также обычно актуально, когда код Java управляет интернационализованным текстом; Проблема не является уникальной для XML.

Обратите внимание, что некоторые средства синтаксического анализа сообщают о пробелах в содержимом элементов с помощью #ignorableWhitespace ignorableWhitespace метода, а не этого (проверка средств <синтаксического анализа em>должна</em> сделать это).

Документация по Java для org.xml.sax.ContentHandler.characters(char[], int, int).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

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

См. также раздел

<xref:Org.Xml.Sax.IContentHandler.IgnorableWhitespace(System.Char%5b%5d%2c+System.Int32%2c+System.Int32)>
ILocator

Поделиться через