ILSParser インターフェイス

定義

名前空間:

Org.W3c.Dom.LS

アセンブリ:

Mono.Android.dll

さまざまな入力ソースから DOM ツリーを構築または拡張できるオブジェクトへのインターフェイス。

[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

属性

RegisterAttribute

実装

IJavaObject IJavaPeerable IDisposable

注釈

さまざまな入力ソースから DOM ツリーを構築または拡張できるオブジェクトへのインターフェイス。

LSParser は、XML を解析し、対応する DOM ドキュメント構造を構築するための API を提供します。 インスタンスは LSParser 、メソッドを DOMImplementationLS.createLSParser() 呼び出すことによって取得できます。

[DOM レベル 3 Core] で指定されているように、ドキュメントが LSParser を介して初めて使用可能になったとき: <ul><li> には、NODE_TEXT型の隣接するノードが 2 つ存在することは決してなく、空のテキスト ノードは存在しません。 </li li>>< ノードのAttr属性はnodeValue、最初に XML 1.0 正規化値を返す必要valueがあります。 ただし、パラメーター " validate-if-schema" と " datatype-normalization" が 、使用される属性の正規化に応じて設定 trueされている場合、属性値は XML 1.0 属性正規化によって取得されたものと異なる場合があります。 パラメーター "datatype-normalization" が設定falseされている場合、XML 1.0 属性の正規化が確実に行われ、属性リストに名前空間宣言が含まれていない場合、attributesノードのElement属性は [XML 情報セット] で定義されているプロパティ <b>[attributes]</b> を表します。 </li></ul>

非同期 LSParser オブジェクトは、イベント リスナーを events::EventTarget 非同期 LSParser オブジェクトに登録できるように、インターフェイスも実装することが期待されます。

非同期 LSParser オブジェクトでサポートされるイベントは、 <dl><dt>load</dt><dd>LSParser です。ドキュメントの読み込みが完了します。 インターフェイスの LSLoadEvent 定義も参照してください。 </dd><dt>progress</dt><dd>LSParser データが解析されると、シグナルが進行します。 この仕様では、進行状況イベントをディスパッチするタイミングを正確に定義しようとはしません。 これは意図的に実装依存として残されています。 アプリケーションが進行状況イベントをディスパッチする方法の 1 つの例を次に示します。パーサーがデータの受信を開始すると、解析が開始されることを示す進行状況イベントがディスパッチされます。 そこから、受信および処理される 4096 バイトのデータごとに進行状況イベントがディスパッチされます。 ただし、これは 1 つの例にすぎません。実装では、解析中にいつでも進行状況イベントをディスパッチするか、まったくディスパッチしないことを選択できます。 インターフェイスの LSProgressEvent 定義も参照してください。 </dd></dl><p ><b>注:</b> この仕様で定義されているすべてのイベントは、名前空間 URI を使用します "http://www.w3.org/2002/DOMLS"。

入力ソースの解析中に、エラー ハンドラー (LSParser.domConfig"error-handler" パラメーター) を使用してエラーがアプリケーションに報告されます。 この仕様では、XML やその他のマークアップの解析中に発生する可能性のあるすべてのエラーを定義しようとはしませんが、一般的なエラーケースがいくつか定義されています。 この仕様で定義されているエラーと警告の種類 (DOMError.type) は、<パラメーター "check-character-normalization" が true に設定され、正規化チェックに失敗する文字列が検出された場合に発生する dl<>dt><"check-character-normalization-failure" [error]/dt><dd> です。 </dd><dt>"doctype-not-allowed" [fatal]</dt><dd> 構成パラメーター "disallow-doctype" が設定され、doctype が検出された場合に true 発生します。 </dd><dt>"no-input-specified" [fatal]</dt><dd> ドキュメントを読み込むときに発生し、オブジェクトに LSInput 入力が指定されません。 </dd><dt>"pi-base-uri-not-preserved" [warning]</dt><dd> 処理命令のベース URI を保持できない場所で処理命令が検出された場合に発生します。 この警告が発生する例の 1 つは、構成パラメーター " entities" が設定 false され、次の XML ファイルが解析された場合です。

<!DOCTYPE root [ <!ENTITY e SYSTEM 'subdir/myentity.ent' ]>
            <root> &e; </root>

次 subdir/myentity.ent のものが含まれます。

<one> <two/> </one> <?pi 3.14159?>
            <more/>

</dd><dt>"unbound-prefix-in-entity" [warning]</dt><dd> 構成パラメーター " namespaces" が設定され、エンティティの置換テキストでバインドされていない名前空間プレフィックスが検出された場合に true 発生する可能性がある実装依存の警告。 一部の既存のパーサーはエンティティの置換テキストで非バインド名前空間プレフィックスを認識しない可能性があるため、この警告を発生させる操作は適用されません。 </dd><dt>"unknown-character-denormalization" [fatal]</dt><dd> 構成パラメーター "ignore-unknown-character-denormalizations" が設定されていて、プロセッサが正規化プロパティを false 決定できない文字が検出された場合に発生します。 </dd><dt>"unsupported-encoding" [fatal]</dt><dd> サポートされていないエンコードが検出された場合に発生します。 </dd><dt>"unsupported-media-type" [fatal]</dt><dd> 構成パラメーター "supported-media-types-only" が設定 true されていて、サポートされていないメディアの種類が検出された場合に発生します。 </dd></dl>

定義されたエラーと警告を発生させるだけでなく、実装では、IO エラー (ファイルが見つからない、アクセス許可が拒否された,...)、XML の整形式エラーなど、その他のエラーや警告の場合に、実装固有のエラーと警告が発生することが期待されます。

ドキュメント オブジェクト モデル (DOM) レベル 3 の読み込みと保存の仕様も 参照してください。

の Java ドキュメントorg.w3c.dom.ls.LSParser

このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。

フィールド

ActionAppendAsChildren	解析操作の結果をコンテキスト ノードの子として追加します。
ActionInsertAfter	解析操作の結果をコンテキスト ノードの直後の兄弟として挿入します。
ActionInsertBefore	解析操作の結果をコンテキスト ノードの直前の兄弟として挿入します。
ActionReplace	コンテキスト ノードを解析操作の結果に置き換えます。
ActionReplaceChildren	コンテキスト ノードのすべての子を解析操作の結果に置き換えます。

プロパティ

Async	true が非同期の LSParser 場合は同期 false です。
Busy	true ドキュメントの LSParser 読み込みが現在ビジー状態の場合は 〗。それ以外の場合 falseは 〗。
DomConfig	DOMConfiguration入力ソースの解析時に使用されるオブジェクト。
Filter	フィルターが提供されると、実装は DOM ツリー構造を構築するときにフィルターを呼び出します。
Handle	基になる Android オブジェクトの JNI 値を取得します。 (継承元 IJavaObject)
JniIdentityHashCode	ラップされたインスタンスの java.lang.System.identityHashCode() 値を返します。 (継承元 IJavaPeerable)
JniManagedPeerState	マネージド ピアの状態。 (継承元 IJavaPeerable)
JniPeerMembers	メンバー アクセスと呼び出しのサポート。 (継承元 IJavaPeerable)
PeerReference	ラップされた Java オブジェクト インスタンスの a JniObjectReference を返します。 (継承元 IJavaPeerable)

メソッド

Abort()	によって現在読み込まれているドキュメントの読み込みを中止します LSParser。
Disposed()	インスタンスが破棄されたときに呼び出されます。 (継承元 IJavaPeerable)
DisposeUnlessReferenced()	このインスタンスへの未処理の参照がない場合は、呼び出 Dispose()します。それ以外の場合は何も行いません。 (継承元 IJavaPeerable)
Finalized()	インスタンスが終了したときに呼び出されます。 (継承元 IJavaPeerable)
Parse(ILSInput)	によって識別されるリソースから XML ドキュメントを LSInput解析します。
ParseURI(String)	URI 参照によって識別される場所から XML ドキュメントを解析する [IETF RFC 2396]。
ParseWithContext(ILSInput, INode, Int16)	a でLSInput識別されたリソースから XML フラグメントを解析し、引数とaction共に指定された位置にある既存のドキュメントにコンテンツをcontext挿入します。
SetJniIdentityHashCode(Int32)	によって JniIdentityHashCode返される値を設定します。 (継承元 IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	さまざまな入力ソースから DOM ツリーを構築または拡張できるオブジェクトへのインターフェイス。 (継承元 IJavaPeerable)
SetPeerReference(JniObjectReference)	によって PeerReference返される値を設定します。 (継承元 IJavaPeerable)
UnregisterFromRuntime()	ランタイムが将来 Java.Interop.JniRuntime+JniValueManager.PeekValue の呼び出しから返されないように、このインスタンスの登録を解除します。 (継承元 IJavaPeerable)

拡張メソッド

JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	さまざまな入力ソースから DOM ツリーを構築または拡張できるオブジェクトへのインターフェイス。
GetJniTypeName(IJavaPeerable)	さまざまな入力ソースから DOM ツリーを構築または拡張できるオブジェクトへのインターフェイス。
ParseAsync(ILSParser, ILSInput)	さまざまな入力ソースから DOM ツリーを構築または拡張できるオブジェクトへのインターフェイス。
ParseURIAsync(ILSParser, String)	さまざまな入力ソースから DOM ツリーを構築または拡張できるオブジェクトへのインターフェイス。
ParseWithContextAsync(ILSParser, ILSInput, INode, Int16)	さまざまな入力ソースから DOM ツリーを構築または拡張できるオブジェクトへのインターフェイス。