IDOMConfiguration インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
インターフェイスは DOMConfiguration
、ドキュメントの構成を表し、認識されたパラメーターのテーブルを保持します。
[Android.Runtime.Register("org/w3c/dom/DOMConfiguration", "", "Org.W3c.Dom.IDOMConfigurationInvoker")]
public interface IDOMConfiguration : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("org/w3c/dom/DOMConfiguration", "", "Org.W3c.Dom.IDOMConfigurationInvoker")>]
type IDOMConfiguration = interface
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 属性
- 実装
注釈
インターフェイスは DOMConfiguration
、ドキュメントの構成を表し、認識されたパラメーターのテーブルを保持します。 構成を使用すると、ノードをノードText
に置き換えたりCDATASection
、検証が要求されたときに使用する必要があるスキーマの種類を指定したりするなどの動作をDocument
変更Document.normalizeDocument()
できます。 DOMConfiguration
オブジェクトは、インターフェイスの [DOM レベル 3 の読み込みと保存] でもDOMSerializer
DOMParser
使用されます。
オブジェクトで DOMConfiguration
使用されるパラメーター名は、DOM レベル 3 の仕様全体で定義されます。 名前の大文字と小文字は区別されません。 競合の可能性を回避するには、慣例として、DOM 仕様の外部で定義されているパラメーターを参照する名前を一意にする必要があります。 パラメーターはプロパティとして公開されるため、名前はセクション 5.16 の [Unicode] の識別子に文字 '-' (ハイフン-マイナス) を追加した後に従うことをお勧めしますが、DOM 実装では適用されません。 DOM レベル 3 のコア実装は、この仕様で定義されているすべてのパラメーターを認識するために必要です。 一部のパラメーター値は、実装でサポートされる必要がある場合もあります。 値をサポートする必要があるかどうかを確認するには、パラメーターの定義を参照してください。 <p ><b>注:</b> パラメーターは、SAX2 [SAX] で使用される機能とプロパティに似ています。
DOM で定義されているパラメーターの一覧: <dl><dt"canonical-form"
<>/dt><dd><dl<>dt><true
/dt><dd>[<em>optional</em>] ツリーからノードを削除したり、各要素から余分な名前空間宣言を削除DocumentType
したりするなど、[Canonical XML] で指定された規則に従ってドキュメントを正規化します。 これは DOM で表すことができるものに限定されることに注意してください。特に、DOM 内の属性の順序を指定する方法はありません。 さらに、このパラメーターを設定すると true
、以下に示すパラメーターの状態も設定されます。 これらのパラメーターの 1 つの状態に後で変更すると、"正規形式" が元に false
戻ります。 パラメーターが false
"entities"、"normalize-characters"、"cdata-sections" に設定されています。 パラメーターは true
、"namespaces"、"namespace-declarations"、"well-formed"、"element-content-namespace" に設定されます。 パラメーターの説明で明示的に指定しない限り、他のパラメーターは変更されません。</dd><dt>false
</dt><dd>[<em>required</em>] (<em>default</em>)ドキュメントを正規化しないでください。</dd>/dl></dd><dt>"cdata-sections"
</dt><dd><dl><dt>true
</dt><dd>[<em>required</em>] (<em>default</em>)ドキュメント内のノードを保持CDATASection
します。<</dd><dt>false
</dt><dd>[<em>required</em>]ドキュメント内のノードをノードにText
変換CDATASection
します。 その後、新しいText
ノードが隣接するノードと組み合わされますText
。</dd></dl></dd><dt>"check-character-normalization"
</dt><dd><dl><dt>true
</dt><dd>[<em>optional</em>] [XML 1.1] の付録 B で定義されているように、ドキュメント内の文字が完全に正規化されているかどうかを確認します。 正規化チェックに失敗する一連の文字が検出されると、"check-character-normalization-failure" と等しいエラー DOMError.type
が発行されます。 </dd><dt>false
</dt><dd>[<em>required</em>] (<em>default</em>)文字が正規化されているかどうかを確認しないでください。</dd>/dl></dd><dt>"comments"
</dt><dd><dl><dt>true
</dt><dd>[<em>required</em>] (<em>default</em>)ドキュメント内のノードを保持Comment
します。<</dd><dt>false
</dt><dd>[<em>required</em>]ドキュメント内のノードを破棄Comment
します。</dd>/dl></dd><dt>"datatype-normalization"
</dt><dd dl>><<dt>true
</dt><dd>[<em>optional</em>] XML スキーマの場合、XML スキーマの正規化された値など、スキーマの正規化された値をツリーで公開します。< このパラメーターにはスキーマ情報が必要であるため、"validate" パラメーターも true
. "validate" false
が有効な場合にこのパラメーターをアクティブにしても効果はなく、スキーマの正規化は行われません。 <p ><b>注:</b> ドキュメントには XML 1.0 処理の結果が含まれるため、[XML 1.0] のセクション 3.3.3 で定義されている属性値の正規化にはこのパラメーターは適用されず、ドキュメント型定義 (DTD) 以外のスキーマ言語のみを対象としています。 </dd><dt>false
</dt><dd>[<em>required</em>] (<em>default</em>) ツリーでスキーマ正規化を実行しません。 </dd>/dl></dd><dt>"element-content-whitespace"
</dt><dd><dl><dt>true
</dt><dd>[<em>required</em] (<em>default</em>>)文書内のすべての空白を保持します。<</dd><dt>false
</dt><dd>[<em>optional</em>] [element content spaces]で説明されているように、要素コンテンツ内の空白を含むすべてのText
ノードを破棄します。 実装では、属性Text.isElementContentWhitespace
を使用してノードをText
破棄するかどうかを判断することが想定されています。</dd>/dl></dd><dt>"entities"
</dt><dd><dl><dt>true
</dt><dd>[<em>required</em>] (<em>default</em>)ドキュメント内のノードを保持EntityReference
します。<</dd><dt>false
</dt><dd>[<em>required</em>] ドキュメントからすべてのEntityReference
ノードを削除し、エンティティの展開を直接配置します。 Text
ノードは、で定義 Node.normalize
されているように正規化されます。 ドキュメントには、展開されていないエンティティ参照のみが保持されます。 </dd></dl><p ><b>注:</b> このパラメーターはノードには影響 Entity
しません。 </dd><dt>"error-handler"
</dt><dd>[<em>required</em>] オブジェクトが DOMErrorHandler
含まれています。 ドキュメントでエラーが発生した場合、実装はこのパラメーターを使用して登録済みを DOMErrorHandler
コールバックします。 実装では、既定 DOMErrorHandler
のオブジェクトが提供される場合があります。 呼び出されると、 DOMError.relatedData
エラーが発生した場所に最も近いノードが含まれます。 エラーが発生したノードを実装が特定できない場合は、 DOMError.relatedData
ノードが Document
含まれます。 エラー ハンドラー内からドキュメントを変更すると、実装に依存する動作が発生します。 </dd><dt>"infoset"
</dt><dd><dl><dt><true
/dt><dd>[<em>required</em>]XML Information Set [XML Information Set] で定義されている情報をドキュメントに保持します。これにより、次のパラメーターが false
"validate-if-schema"、"entities"、"datatype-normalization"、"cdata-sections" に強制されます。これにより、"namespace-declarations"、"well-formed"、"element-content-namespace"、"comments"、"namespaces" というパラメーターtrue
が強制的に適用されます。パラメーターの説明で明示的に指定しない限り、他のパラメーターは変更されません。 このパラメーターに対してクエリを実行すると、true
上記でgetParameter
指定した個々のパラメーターが適切に設定されている場合にのみ、戻り値が返されることに注意してください。</dd><dt>false
</dt><dd>設定infoset
はfalse
無効です。</dd></dl></dd><dt>"namespaces"
</dt><dd><dl><dt>true
</dt><dd>[<em>required</em] (<em>default</em>>) で定義されている名前空間処理を実行します。 </dd><dt>false
</dt><dd>[<em>optional</em>] 名前空間の処理を実行しないでください。 </dd></dl></dd><dt><"namespace-declarations"
/dt><dd> このパラメーターは、パラメーター "namespaces" が .false
<dl><dt>true
</dt><dd>[<em>required</em>] (<em>default</em>) スキーマから指定または既定の名前空間宣言属性をドキュメントに含めます。 「XML 名前空間」および「XML 名前空間 1.1」の「名前空間の宣言」セクションも参照してください。</dd><dt>false
</dt><dd>[<em>required</em>]すべての名前空間宣言属性を破棄します。 このパラメーターが > に設定false
されている場合でも、名前空間プレフィックス ( Node.prefix
) は保持されます。</dd>/dl></dd><dt><"normalize-characters"
/dt><dd><dl><dt>true
</dt><dd>[<em>optional</em>] [XML 1.1] の付録 B で定義されているように、ドキュメント内の文字を完全に正規化しました。< </dd><dt>false
</dt><dd>[<em>required</em>] (<em>default</em>)文字正規化を実行しません。</dd></dl></dd><dt>"schema-location"
</dt><dd>[<em>optional</em>] DOMString
検証の対象となるスキーマ (つまり、現在のスキーマ) を表す空白文字 (セクション 2.3 [XML 1.0] で定義された非終端運用 S に一致する文字) で区切られた URI のリストを含むオブジェクトを表します。 このリストで参照されるスキーマの型は、指定された型と schema-type
一致する必要があります。それ以外の場合、実装の動作は未定義です。 このプロパティを使用して指定されたスキーマは、ドキュメント自体で指定されたスキーマ情報よりも優先されます。 名前空間対応スキーマの場合、このプロパティを使用して指定されたスキーマと、スキーマ ドキュメント内のドキュメント インスタンスで指定されたスキーマ (つまり、スキーマ メカニズムを使用 schemaLocation
) で指定されたスキーマ import
が同じ targetNamespace
を共有する場合、このプロパティを使用するユーザーによって指定されたスキーマが使用されます。 このプロパティを使用して指定された 2 つのスキーマが同じ targetNamespace
か名前空間を持たない場合、動作は実装に依存します。 場所が指定されていない場合、このパラメーターは null
. <p ><b>注:</b>"schema-location"
"schema-type" パラメーター値が設定されていない限り、パラメーターは無視されます。 実装が参照されている外部エンティティを正常に解決できるように設定することを強くお勧めします Document.documentURI
。 </dd><dt>"schema-type"
</dt><dd>[<em>optional</em>] 絶対 URI を含み、ドキュメントの検証に使用されるスキーマ言語の型を表すオブジェクトを表 DOMString
します。 絶対 URI では字句チェックは行われません。 このパラメーターが設定されていない場合は、サポートされているスキーマ言語と読み込み時に使用されるスキーマ言語に基づいて、実装によって既定値が提供される場合があります。 値が指定されていない場合、このパラメーターは null
. <p ><b>注:</b> XML スキーマの場合 [XML スキーマ パート 1] では、アプリケーションで値 "http://www.w3.org/2001/XMLSchema"
を使用する必要があります。 XML DTD [XML 1.0] の場合、アプリケーションでは値 "http://www.w3.org/TR/REC-xml"
を使用する必要があります。 他のスキーマ言語は W3C の範囲外であるため、このメソッドを使用するには絶対 URI を推奨する必要があります。 </dd dt>"split-cdata-sections"
<<>/dt><dd><dl><dt>true
</dt><dd>[<em>required</em>] (<em>default</em>)CDATA セクション終了マーカー ']]]> を含む CDATA セクションを分割します。 CDATA セクションが分割されると、分割の結果としてドキュメントの順序でDOMError.type
最初CDATASection
のノードとDOMError.relatedData
等しいと等しい"cdata-sections-splitted"
警告が発行されます。</dd><dt>false
</dt><dd>[<em>required</em>]解釈できない文字が含まれている場合CDATASection
にエラーを通知します。</dd>/dl></dd><dt><"validate"
/dt><dd><dl><dt><true
/dt><dd>[<em>optional</em>] [XML 1.0] で定義されているように正規化されているため、ドキュメントのスキーマ (i.e. XML スキーマ、DTD、その他の種類またはスキーマの表現) に対する検証が必要です。< 検証エラーが見つかった場合、またはスキーマが見つからなかった場合は、エラー ハンドラーに通知されます。 パラメーター "datatype-normalization" が指定されていない限り、スキーマ正規化された値は true
、使用されているスキーマに従って公開されません。 このパラメーターは、インターフェイスの説明Attr
で指定されているように、等しい false
ul><li> 属性ノードAttr.specified
を再評価<します<。/li li><> すべてのText
ノードの属性Text.isElementContentWhitespace
の値。 </li li><> すべてのAttr
ノードの属性Attr.isId
の値。 </li li>>< 属性Element.schemaTypeInfo
と .Attr.schemaTypeInfo
</li></ul><p ><b>注:</b> "validate-if-schema" と "validate" は相互に排他的であり、そのうちの 1 つを true
設定すると、もう 1 つは false
. アプリケーションでは、ドキュメントを検証するときに、パラメーター "well-formed" をそのオプションの既定値である "well-formed" true
に設定することも検討する必要があります。 </dd><dt>false
</dt><dd>[<em>required</em>] (<em>default</em>) 内部サブセット処理を含むスキーマ処理を実行しないでください。 既定の属性値情報は保持されます。 "validate-if-schema" が true
. </dd></dl></dd><dt><"validate-if-schema"
/dt><dd><dl><dt>true
</dt><dd>[<em>optional</em>]ドキュメント要素の宣言がスキーマ内で見つかる場合にのみ検証を有効にします (存在する場所、i.e. XMLスキーマ、DTD、またはその他のスキーマの型または表現とは別に)。 検証が有効な場合、このパラメーターの動作はパラメーター "validate" と true
同じです。 <p ><b>注:</b> "validate-if-schema" と "validate" は相互に排他的であり、そのうちの 1 つを true
設定すると、もう 1 つは false
. </dd><dt>false
</dt><dd>[<em>required</em>] (<em>default</em>) ドキュメントに内部サブセット処理を含むスキーマがある場合は、スキーマ処理を実行する必要はありません。 既定の属性値情報は保持されます。 "validate" が true
. </dd>/dl></dd><dt>"well-formed"
</dt><dd><dt>><true
</dt<>dd>[<em>required/em required</em] (<em>default</em>>) で使用Document.xmlVersion
されている XML バージョンに従って、すべてのノードが XML 整形式であるかどうかを確認します。<ul<>li> は、属性Node.nodeName
にノードの種類に応じて無効な文字が含まれているかどうかを確認し、必要に応じて重大度を持つDOMError.SEVERITY_ERROR
型"wf-invalid-character-in-node-name"
を生成DOMError
します。 <</li li>><は、無効な文字のノード内Comment
Element
Attr
Text
CDATASection
のテキストコンテンツをチェックし、必要に応じて重大度を持つDOMError.SEVERITY_ERROR
型"wf-invalid-character"
を生成DOMError
します。 </li li><> は、ノード内ProcessingInstruction
のデータに無効な文字があるかどうかを確認し、必要に応じて重大度を持つDOMError.SEVERITY_ERROR
型"wf-invalid-character"
を生成DOMError
します。 </li></ul></dd><dt><false
/dt><dd>[<em>optional</em>] XML の整形式を確認しないでください。 </dd></dl></dd></dl>
エンティティに関連付けられているシステム識別子の解決は Document.documentURI
、 ただし、[DOM レベル 3 の読み込みと保存] で定義されている機能 "LS" が DOM 実装でサポートされている場合は、ノードにDOMConfiguration
アタッチされているDocument
オブジェクトでもパラメーター "resource-resolver" を使用できます。 このパラメーターが設定されている場合は、 Document.normalizeDocument()
使用する代わりにリソース リゾルバーを Document.documentURI
呼び出します。
ドキュメント オブジェクト モデル (DOM) レベル 3 コア仕様も参照してください。
DOM レベル 3 で追加されました。
の Java ドキュメントorg.w3c.dom.DOMConfiguration
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。
プロパティ
Handle |
基になる Android オブジェクトの JNI 値を取得します。 (継承元 IJavaObject) |
JniIdentityHashCode |
ラップされたインスタンスの |
JniManagedPeerState |
マネージド ピアの状態。 (継承元 IJavaPeerable) |
JniPeerMembers |
メンバー アクセスと呼び出しのサポート。 (継承元 IJavaPeerable) |
ParameterNames |
この |
PeerReference |
ラップされた Java オブジェクト インスタンスの a JniObjectReference を返します。 (継承元 IJavaPeerable) |
メソッド
CanSetParameter(String, Object) |
パラメーターを特定の値に設定することがサポートされているかどうかを確認します。 |
Disposed() |
インスタンスが破棄されたときに呼び出されます。 (継承元 IJavaPeerable) |
DisposeUnlessReferenced() |
このインスタンスへの未処理の参照がない場合は、呼び出 |
Finalized() |
インスタンスが終了したときに呼び出されます。 (継承元 IJavaPeerable) |
GetParameter(String) |
既知の場合は、パラメーターの値を返します。 |
SetJniIdentityHashCode(Int32) |
によって |
SetJniManagedPeerState(JniManagedPeerStates) |
インターフェイスは |
SetParameter(String, Object) |
パラメーターの値を設定します。 |
SetPeerReference(JniObjectReference) |
によって |
UnregisterFromRuntime() |
ランタイムが将来 Java.Interop.JniRuntime+JniValueManager.PeekValue の呼び出しから返されないように、このインスタンスの登録を解除します。 (継承元 IJavaPeerable) |
拡張メソッド
JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
JavaCast<TResult>(IJavaObject) |
インターフェイスは |
GetJniTypeName(IJavaPeerable) |
インターフェイスは |