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:dldtSTART_DOCUMENTddnull dtEND_DOCUMENT dd null dtSTART_TAGddnull, если не включена FEATURE_XML_ROUNDTRIP, а затем возвращает xml-тег, например < tag attr='val'dt END_TAG ddnull, если не включен идентификатор FEATURE_XML_ROUNDTRIP, а затем возвращает xml-тег, например dtTEXTddreturn content. <Br>Примечание. Содержимое элемента может быть доставлено в несколько последовательных событий TEXT. <dt>IGNORABLE_WHITESPACE<возвращаемые символы dd>, которые определяются как игнорируемые пробелы. Если FEATURE_XML_ROUNDTRIP включен весь контент пробелов за пределами корневого элемента всегда будет сообщаться как IGNORABLE_WHITESPACE в противном случае отчеты необязательны. <Br>Примечание. Содержимое элемента может быть доставлено в несколько последовательных событий IGNORABLE_WHITESPACE. dtCDSECTdd return text eminside/em CDATA (например, 'fo< o' из ) dtPROCESSING_INSTRUCTIONdd , если FEATURE_XML_ROUNDTRIP является истинным возвратом точного содержимого PI ex: "pi foo" из в противном случае это может быть точное содержимое pi или объединение целевого объекта PI, пространства и данных, например для строка " целевые данные" может быть возвращен, если FEATURE_XML_ROUNDTRIP имеет значение false. <dt>COMMENT<dd>возвращает содержимое комментария, например. 'foo bar' from dtENTITY_REFddgetText() ДОЛЖЕН возвращать текст замены сущности, если PROCESS_DOCDECL значение false в противном случае getText() MAY возвращает значение NULL, дополнительно getTextCharacters() ДОЛЖНО возвращать имя сущности (например, "entity_name" для & entity_name;). <br><b>NOTE:</b> это единственное место, где значение, возвращаемое из getText() и getTextCharacters() отличается</b><><br b>ПРИМЕЧАНИЕ:</b> это пользователь несет ответственность за разрешение ссылки на сущности, если PROCESS_DOCDECL имеет значение false, и в методе defineEntityReplacementText() (getText() <>будет иметь значение NULL)><< br b>ПРИМЕЧАНИЕ:</b b> сущности символов (например, ) и стандартные сущности, такие как & amp; & lt; & gt; & quot; & apos; также сообщается и b не</b> сообщается <>как текстовые маркеры, но как ENTITY_REF маркеры! Это требование добавляется для того, чтобы разрешить циклический обход XML-документов! <dt>DOCDECL dd,> если FEATURE_XML_ROUNDTRIP имеет значение true или PROCESS_DOCDECL имеет значение false, то возвращает то, что находится внутри DOCDECL<, например возвращается:

" 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.

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

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

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".