ILSParser Antarmuka

Referensi

Definisi

Ruang nama:: Org.W3c.Dom.LS

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.

Antarmuka ke objek yang dapat membangun, atau menambah, pohon DOM dari berbagai sumber input.

[Android.Runtime.Register("org/w3c/dom/ls/LSParser", "", "Org.W3c.Dom.LS.ILSParserInvoker")]
public interface ILSParser : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("org/w3c/dom/ls/LSParser", "", "Org.W3c.Dom.LS.ILSParserInvoker")>]
type ILSParser = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Atribut: RegisterAttribute

Penerapan: IJavaObject IJavaPeerable IDisposable

Keterangan

Antarmuka ke objek yang dapat membangun, atau menambah, pohon DOM dari berbagai sumber input.

LSParser menyediakan API untuk mengurai XML dan membangun struktur dokumen DOM yang sesuai. Instans LSParser dapat diperoleh dengan memanggil DOMImplementationLS.createLSParser() metode .

Seperti yang ditentukan dalam [DOM Level 3 Core] , ketika dokumen pertama kali tersedia melalui LSParser: <ul><li> tidak akan pernah ada dua simpul jenis NODE_TEXT yang berdekatan, dan tidak akan pernah ada simpul teks kosong. </li><li> diharapkan bahwa value atribut dan nodeValue dari simpul Attr awalnya mengembalikan nilai XML 1.0 yang dinormalisasi. Namun, jika parameter " validate-if-schema" dan " datatype-normalization" diatur ke true, tergantung pada normalisasi atribut yang digunakan, nilai atribut mungkin berbeda dari yang diperoleh oleh normalisasi atribut XML 1.0. Jika parameter " datatype-normalization" diatur ke false, normalisasi atribut XML 1.0 dijamin terjadi, dan jika daftar atribut tidak berisi deklarasi namespace, attributes atribut pada Element simpul mewakili properti [atribut] yang ditentukan dalam [Set Informasi XML] . </li></ul>

Objek asinkron LSParser diharapkan juga mengimplementasikan events::EventTarget antarmuka sehingga pendengar peristiwa dapat didaftarkan pada objek asinkron LSParser .

Peristiwa yang didukung oleh objek asinkron LSParser adalah: <dl><dt>load</dt><dd> Selesai LSParser untuk memuat dokumen. Lihat juga definisi LSLoadEvent antarmuka. </dd><dt>progress</dt><dd> Kemajuan LSParser sinyal saat data diurai. Spesifikasi ini tidak mencoba menentukan dengan tepat kapan peristiwa kemajuan harus dikirim. Itu sengaja dibiarkan sebagai dependen implementasi. Berikut adalah salah satu contoh bagaimana aplikasi mungkin mengirimkan peristiwa kemajuan: Setelah pengurai mulai menerima data, peristiwa kemajuan dikirim untuk menunjukkan bahwa penguraian dimulai. Dari sana, peristiwa kemajuan dikirim untuk setiap 4096 byte data yang diterima dan diproses. Namun, ini hanya satu contoh, dan implementasi dapat memilih untuk mengirimkan peristiwa kemajuan kapan saja saat mengurai, atau tidak mengirimkannya sama sekali. Lihat juga definisi LSProgressEvent antarmuka. </dd></dl>Note: Semua peristiwa yang ditentukan dalam spesifikasi ini menggunakan namespace URI "http://www.w3.org/2002/DOMLS".

Saat mengurai sumber input, kesalahan dilaporkan ke aplikasi melalui handler kesalahan (LSParser.domConfigparameter " error-handler"). Spesifikasi ini sama sekali tidak mencoba menentukan semua kemungkinan kesalahan yang dapat terjadi saat mengurai XML, atau markup lainnya, tetapi beberapa kasus kesalahan umum ditentukan. Jenis (DOMError.type) kesalahan dan peringatan yang ditentukan oleh spesifikasi ini adalah: <dl><dt><"check-character-normalization-failure" [error]/dt><dd> Dimunculkan jika parameter " check-character-normalization" diatur ke true dan string ditemukan yang gagal pemeriksaan normalisasi. </dd><dt>"doctype-not-allowed" [fatal]</dt><dd> Dimunculkan jika parameter konfigurasi "disallow-doctype" diatur ke true dan doctype ditemui. </dd><dt>"no-input-specified" [fatal]</dt><dd> Dimunculkan saat memuat dokumen dan tidak ada input yang ditentukan dalam LSInput objek. </dd><dt>"pi-base-uri-not-preserved" [warning]</dt><dd> Dinaikkan jika instruksi pemrosesan ditemui di lokasi di mana URI dasar instruksi pemrosesan tidak dapat dipertahankan. Salah satu contoh kasus di mana peringatan ini akan dimunculkan adalah jika parameter konfigurasi " entitas" diatur ke false dan file XML berikut diurai:

&lt;!DOCTYPE root [ &lt;!ENTITY e SYSTEM 'subdir/myentity.ent' ]&gt;
            &lt;root&gt; &amp;e; &lt;/root&gt;

Dan subdir/myentity.ent berisi:

&lt;one&gt; &lt;two/&gt; &lt;/one&gt; &lt;?pi 3.14159?&gt;
            &lt;more/&gt;

</dd><dt><"unbound-prefix-in-entity" [warning]/dt><dd> Peringatan dependen implementasi yang dapat dinaikkan jika parameter konfigurasi " namespace" diatur ke true dan awalan namespace tidak terikat ditemui dalam teks pengganti entitas. Menaikkan peringatan ini tidak diberlakukan karena beberapa pengurai yang ada mungkin tidak mengenali awalan namespace yang tidak terikat dalam teks pengganti entitas. </dd><dt>"unknown-character-denormalization" [fatal]</dt><dd> Dimunculkan jika parameter konfigurasi "ignore-unknown-character-denormalizations" diatur ke false dan karakter ditemui di mana prosesor tidak dapat menentukan properti normalisasi. </dd><dt>"unsupported-encoding" [fatal]</dt><dd> Dimunculkan jika pengodean yang tidak didukung ditemui. </dd><dt>"unsupported-media-type" [fatal]</dt><dd> Dimunculkan jika parameter konfigurasi "supported-media-type-only" diatur ke true dan jenis media yang tidak didukung ditemui. </dd></dl>

Selain meningkatkan kesalahan dan peringatan yang ditentukan, implementasi diharapkan untuk meningkatkan kesalahan dan peringatan spesifik implementasi untuk kesalahan dan kasus peringatan lainnya seperti kesalahan IO (file tidak ditemukan, izin ditolak,...), kesalahan kesejahteraan XML, dan sebagainya.

Lihat juga Model Objek Dokumen (DOM) Tingkat 3 Memuat dan Menyimpan Spesifikasi.

Dokumentasi Java untuk org.w3c.dom.ls.LSParser.

Bagian halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Proyek Sumber Terbuka Android dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Atribusi Creative Commons 2.5.

Bidang

ActionAppendAsChildren	Tambahkan hasil operasi penguraian sebagai turunan dari simpul konteks.
ActionInsertAfter	Sisipkan hasil operasi penguraian sebagai saudara kandung dari simpul konteks berikut.
ActionInsertBefore	Masukkan hasil operasi penguraian sebagai saudara kandung dari simpul konteks sebelumnya.
ActionReplace	Ganti simpul konteks dengan hasil operasi penguraian.
ActionReplaceChildren	Ganti semua turunan simpul konteks dengan hasil operasi penguraian.

Properti

Async	`trueLSParser` jika asinkron, `false` jika sinkron.
Busy	`trueLSParser` jika saat ini sibuk memuat dokumen, jika tidak`false`.
DomConfig	Objek yang `DOMConfiguration` digunakan saat mengurai sumber input.
Filter	Ketika filter disediakan, implementasi akan memanggil filter karena membangun struktur pohon DOM.
Handle	Mendapatkan nilai JNI dari objek Android yang mendasar. (Diperoleh dari IJavaObject)
JniIdentityHashCode	Mengembalikan nilai `java.lang.System.identityHashCode()` untuk instans yang dibungkus. (Diperoleh dari IJavaPeerable)
JniManagedPeerState	Status serekan terkelola. (Diperoleh dari IJavaPeerable)
JniPeerMembers	Akses anggota dan dukungan pemanggilan. (Diperoleh dari IJavaPeerable)
PeerReference	Mengembalikan instans objek Java yang dibungkus JniObjectReference . (Diperoleh dari IJavaPeerable)

Metode

Abort()	Batalkan pemuatan dokumen yang saat ini sedang dimuat oleh `LSParser`.
Disposed()	Dipanggil ketika instans telah dibuang. (Diperoleh dari IJavaPeerable)
DisposeUnlessReferenced()	Jika tidak ada referensi yang luar biasa untuk instans ini, maka panggilan `Dispose()`; jika tidak, tidak melakukan apa pun. (Diperoleh dari IJavaPeerable)
Finalized()	Dipanggil ketika instans telah diselesaikan. (Diperoleh dari IJavaPeerable)
Parse(ILSInput)	Mengurai dokumen XML dari sumber daya yang diidentifikasi oleh `LSInput`.
ParseURI(String)	Mengurai dokumen XML dari lokasi yang diidentifikasi oleh referensi URI [IETF RFC 2396].
ParseWithContext(ILSInput, INode, Int16)	Uraikan fragmen XML dari sumber daya yang diidentifikasi oleh `LSInput` dan sisipkan konten ke dalam dokumen yang ada pada posisi yang ditentukan dengan `context` argumen dan `action` .
SetJniIdentityHashCode(Int32)	Atur nilai yang dikembalikan oleh `JniIdentityHashCode`. (Diperoleh dari IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Antarmuka ke objek yang dapat membangun, atau menambah, pohon DOM dari berbagai sumber input. (Diperoleh dari IJavaPeerable)
SetPeerReference(JniObjectReference)	Atur nilai yang dikembalikan oleh `PeerReference`. (Diperoleh dari IJavaPeerable)
UnregisterFromRuntime()	Batalkan pendaftaran instans ini sehingga runtime tidak akan mengembalikannya dari pemanggilan di masa mendatang Java.Interop.JniRuntime+JniValueManager.PeekValue . (Diperoleh dari IJavaPeerable)

Metode Ekstensi

JavaCast<TResult>(IJavaObject)	Melakukan konversi jenis yang diperiksa runtime Bahasa Umum Android.
JavaCast<TResult>(IJavaObject)	Antarmuka ke objek yang dapat membangun, atau menambah, pohon DOM dari berbagai sumber input.
GetJniTypeName(IJavaPeerable)	Antarmuka ke objek yang dapat membangun, atau menambah, pohon DOM dari berbagai sumber input.
ParseAsync(ILSParser, ILSInput)	Antarmuka ke objek yang dapat membangun, atau menambah, pohon DOM dari berbagai sumber input.
ParseURIAsync(ILSParser, String)	Antarmuka ke objek yang dapat membangun, atau menambah, pohon DOM dari berbagai sumber input.
ParseWithContextAsync(ILSParser, ILSInput, INode, Int16)	Antarmuka ke objek yang dapat membangun, atau menambah, pohon DOM dari berbagai sumber input.

Berlaku untuk

Bagikan melalui