IXmlPullParser.NextToken Metode

Definisi

Ruang nama:: Org.XmlPull.V1

Rakitan:: Mono.Android.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Metode ini berfungsi sama dengan next() tetapi akan mengekspos jenis peristiwa tambahan (COMMENT, CDSECT, DOCDECL, ENTITY_REF, PROCESSING_INSTRUCTION, atau IGNORABLE_WHITESPACE) jika tersedia dalam input.

[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

Mengembalikan

XmlPullParserNode

Atribut: RegisterAttribute

Pengecualian

XmlPullParserException

IOException

Keterangan

Jika fitur khusus FEATURE_XML_ROUNDTRIP (diidentifikasi oleh URI: http://xmlpull.org/v1/doc/features.html#xml-roundtrip) diaktifkan dimungkinkan untuk melakukan perjalanan pulang pergi dokumen XML yaitu. reproduksi secara menyeluruh pada output input XML menggunakan getText(): konten yang dikembalikan selalu tidak dinormalisasi (persis seperti dalam input). Jika tidak, konten yang dikembalikan adalah akhir baris yang dinormalisasi seperti yang dijelaskan XML 1.0 Penanganan Akhir Baris dan. Juga ketika fitur ini diaktifkan konten START_TAG, END_TAG, DOCDECL, dan PROCESSING_INSTRUCTION tersedia.

Berikut adalah daftar token yang dapat dikembalikan dari nextToken() dan apa yang getText() dan getTextCharacters() mengembalikan:dldtSTART_DOCUMENTddnull dtEND_DOCUMENTddnull dtSTART_TAGddnull kecuali FEATURE_XML_ROUNDTRIP diaktifkan dan kemudian mengembalikan tag XML, mis: < tag attr='val'dt END_TAG ddnull kecuali id FEATURE_XML_ROUNDTRIP diaktifkan dan kemudian mengembalikan tag XML, misalnya: dtTEXTddmengembalikan konten elemen. <Catatan br>: konten elemen tersebut dapat dikirimkan dalam beberapa peristiwa TEXT berturut-turut. <dt>IGNORABLE_WHITESPACE<dd>mengembalikan karakter yang ditentukan untuk diabaikan spasi kosong. Jika FEATURE_XML_ROUNDTRIP diaktifkan, semua konten spasi kosong di luar elemen akar akan selalu dilaporkan sebagai IGNORABLE_WHITESPACE jika tidak, pelaporan bersifat opsional. <Catatan br>: konten elemen tersebut dapat dikirimkan dalam beberapa peristiwa IGNORABLE_WHITESPACE berturut-turut. dtCDSECTdd mengembalikan teks kedalam/em CDATA (mis. 'fo< o' dari ) dtPROCESSING_INSTRUCTIONdd jika FEATURE_XML_ROUNDTRIP true return exact PI content ex: 'pi foo' from jika tidak, mungkin konten PI yang tepat atau perangkaian target PI, ruang dan data jadi misalnya untuk string " target data&kuota; dapat dikembalikan jika FEATURE_XML_ROUNDTRIP salah. <dt>COMMENT<dd>kembalikan konten komentar ex. 'foo bar' dari dtENTITY_REFddgetText() HARUS mengembalikan teks penggantian entitas jika PROCESS_DOCDECL salah jika tidak getText() MUNGKIN mengembalikan null, selain itu getTextCharacters() HARUS mengembalikan nama entitas (misalnya 'entity_name' untuk & entity_name;). ini adalah satu-satunya tempat di mana nilai yang dikembalikan dari getText() dan getTextCharacters() berbeda NOTE: adalah tanggung jawab pengguna untuk menyelesaikan referensi entitas jika PROCESS_DOCDECL salah dan tidak ada teks pengganti entitas yang ditetapkan dalam metode defineEntityReplacementText() (getText() akan null) NOTE:>>< entitas karakter (mis. ) dan entitas standar seperti & amp; & lt; & gt; & kuotasi; & apos; juga dilaporkan dan b <>tidak dilaporkan sebagai token TEXT tetapi sebagai token ENTITY_REF! Persyaratan ini ditambahkan untuk memungkinkan melakukan pulang pergi dokumen XML! <dt>DOCDECL<dd> jika FEATURE_XML_ROUNDTRIP benar atau PROCESS_DOCDECL salah maka kembalikan apa yang ada di dalam DOCDECL misalnya mengembalikan:

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

untuk dokumen input yang berisi:

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

jika tidak jika FEATURE_XML_ROUNDTRIP salah dan PROCESS_DOCDECL benar maka apa yang dikembalikan tidak ditentukan (bahkan mungkin null) </dd></dl>

<CATATAN yang kuat>:</kuat> tidak ada jaminan bahwa hanya akan ada satu TEKS atau peristiwa IGNORABLE_WHITESPACE dari nextToken() karena pengurai dapat memilih untuk mengirimkan konten elemen dalam beberapa token (membagi konten elemen menjadi gugus)

<catatan>kuat:</kuat> apakah teks token yang dikembalikan adalah akhir baris yang dinormalisasi tergantung pada FEATURE_XML_ROUNDTRIP.

catatan kuat:/XMLDecl kuat () tidak dilaporkan tetapi kontennya tersedia melalui properti opsional (lihat deskripsi kelas di atas).

Java dokumentasi untuk org.xmlpull.v1.XmlPullParser.nextToken().

Bagian dari halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Android Open Source Project dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Creative Commons 2.5 Lisensi Atribusi.

Berlaku untuk