IXmlPullParser.NextToken Метод

Определение

Пространство имен:

Org.XmlPull.V1

Сборка:

Mono.Android.dll

Этот метод работает аналогично next(), но предоставляет дополнительные типы событий (COMMENT, CDSECT, DOCDECL, ENTITY_REF, PROCESSING_INSTRUCTION или IGNORABLE_WHITESPACE), если они доступны во входных данных.

[Android.Runtime.Register("nextToken", "()I", "GetNextTokenHandler:Org.XmlPull.V1.IXmlPullParserInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.XmlPull.V1.XmlPullParserNode NextToken ();

[<Android.Runtime.Register("nextToken", "()I", "GetNextTokenHandler:Org.XmlPull.V1.IXmlPullParserInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member NextToken : unit -> Org.XmlPull.V1.XmlPullParserNode

Возвращаемое значение

XmlPullParserNode

Атрибуты

RegisterAttribute

Исключения

XmlPullParserException

IOException

Комментарии

Этот метод работает аналогично next(), но предоставляет дополнительные типы событий (COMMENT, CDSECT, DOCDECL, ENTITY_REF, PROCESSING_INSTRUCTION или IGNORABLE_WHITESPACE), если они доступны во входных данных.

Если специальные функции FEATURE_XML_ROUNDTRIP (идентифицируются по URI: http://xmlpull.org/v1/doc/features.html#xml-roundtrip) включена возможность выполнить обход XML-документа ie. Воспроизводит эксективно выходные данные XML с помощью getText(): возвращаемое содержимое всегда ненормализовано (точно так же, как и во входных данных). В противном случае возвращенное содержимое нормализовано в конце строки, как описано в формате XML 1.0 End-of-Line Handling and. Кроме того, если эта функция включена точное содержимое START_TAG, END_TAG, DOCDECL и PROCESSING_INSTRUCTION доступны.

Ниже приведен список маркеров, которые можно вернуть из nextToken() и getTextCharacters() и getTextCharacters() return:<dl<>dt>START_DOCUMENT<dd>null dt>END_DOCUMENT dd null <<dt>START_TAG<<dd>>null, если не включена FEATURE_XML_ROUNDTRIP, а затем возвращает xml-тег, например < tag attr='val'dt END_TAG dd>null, если не включен идентификатор FEATURE_XML_ROUNDTRIP<, а затем возвращает xml-тег, например

" titlepage SYSTEM "http://www.foo.bar/dtds/typo.dtd"
            [<!ENTITY % active.links "INCLUDE">]"

для входного документа, содержащего:

<!DOCTYPE titlepage SYSTEM "http://www.foo.bar/dtds/typo.dtd"
            [<!ENTITY % active.links "INCLUDE">]>

в противном случае, если FEATURE_XML_ROUNDTRIP имеет значение false и PROCESS_DOCDECL имеет значение true, то возвращаемое значение не определено (оно может быть даже null) </dd></dl>

<strong>NOTE:</strong> нет гарантии того, что будет только одно событие TEXT или IGNORABLE_WHITESPACE из nextToken(), так как средство синтаксического анализа может выбрать доставку содержимого элемента в нескольких токенах (деление содержимого элемента на блоки)

<strong>NOTE:</strong> , является ли возвращенный текст маркера нормализованным в конце строки в зависимости от FEATURE_XML_ROUNDTRIP.

<strong>NOTE:</strong> XMLDecl () не сообщается, но его содержимое доступно через необязательные свойства (см. описание класса выше).

Документация по Java для org.xmlpull.v1.XmlPullParser.nextToken().

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