IXmlPullParser.NextToken Método

Referência

Definição

Namespace:: Org.XmlPull.V1

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Esse método funciona de forma semelhante ao next(), mas irá expor tipos de eventos adicionais (COMMENT, CDSECT, DOCDECL, ENTITY_REF, PROCESSING_INSTRUCTION ou IGNORABLE_WHITESPACE) se eles estiverem disponíveis na entrada.

[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

Retornos

XmlPullParserNode

Atributos: RegisterAttribute

Exceções

XmlPullParserException

IOException

Comentários

Se o recurso especial FEATURE_XML_ROUNDTRIP (identificado por URI: http://xmlpull.org/v1/doc/features.html#xml-roundtrip) estiver habilitado, é possível fazer documento XML de ida e volta, ou seja, reproduzir exectly na saída a entrada XML usando getText(): o conteúdo retornado é sempre não normalizado (exatamente como na entrada). Caso contrário, o conteúdo retornado será normalizado no fim de linha conforme descrito em XML 1.0 End-of-Line Handling e. Além disso, quando esse recurso está habilitado, o conteúdo exato do START_TAG, END_TAG, DOCDECL e PROCESSING_INSTRUCTION está disponível.

Aqui está a lista de tokens que podem ser retornados de nextToken() e o que getText() e getTextCharacters() retorna:<dl<>dt>START_DOCUMENT<dd>null <dt>END_DOCUMENT<dd>null <dt>START_TAG<dd>null, a menos que FEATURE_XML_ROUNDTRIP habilitado e, em seguida, retorna a marca XML, ex: < tag attr='val'dt><> END_TAG<dd>null a menos que FEATURE_XML_ROUNDTRIP id esteja habilitado e, em seguida, retorne a marca XML, ex:

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

para documento de entrada que continha:

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

caso contrário, se FEATURE_XML_ROUNDTRIP é falso e PROCESS_DOCDECL é verdadeiro, então o que é retornado é indefinido (pode ser até nulo) </dd></dl>

<strong>NOTA:</strong> não há garantia de que haverá apenas um evento TEXT ou IGNORABLE_WHITESPACE do nextToken(), pois o analisador pode optar por entregar o conteúdo do elemento em vários tokens (dividindo o conteúdo do elemento em partes)

<strong>NOTA:</strong> se o texto retornado do token é normalizado no fim de linha depende de FEATURE_XML_ROUNDTRIP.

<>forte NOTA:</forte> XMLDecl () não é relatado, mas seu conteúdo está disponível por meio de propriedades opcionais (consulte a descrição da classe acima).

Documentação Java para org.xmlpull.v1.XmlPullParser.nextToken().

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Aplica-se a

Compartilhar via