IDOMConfiguration Interfaccia

Definizione

Spazio dei nomi:

Org.W3c.Dom

Assembly:

Mono.Android.dll

L'interfaccia DOMConfiguration rappresenta la configurazione di un documento e gestisce una tabella di parametri riconosciuti.

[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

Attributi

RegisterAttribute

Implementazioni

IJavaObject IJavaPeerable IDisposable

Commenti

L'interfaccia DOMConfiguration rappresenta la configurazione di un documento e gestisce una tabella di parametri riconosciuti. Usando la configurazione, è possibile modificare Document.normalizeDocument() il comportamento, ad esempio sostituendo i CDATASection nodi con Text nodi o specificando il tipo dello schema che deve essere usato quando viene richiesta la convalida dell'oggetto Document . DOMConfiguration gli oggetti vengono usati anche in [Carico e salvataggio DOM Livello 3] nelle DOMParser interfacce e DOMSerializer .

I nomi dei parametri usati dall'oggetto DOMConfiguration sono definiti in tutte le specifiche DOM Level 3. Per i nomi viene fatta distinzione tra maiuscole e minuscole. Per evitare conflitti possibili, come convenzione, i nomi che fanno riferimento ai parametri definiti all'esterno della specifica DOM devono essere resi univoci. Poiché i parametri vengono esposti come proprietà nei nomi , è consigliabile seguire la sezione 5.16 Identificatori di [Unicode] con l'aggiunta del carattere '-' (HYPHEN-MINUS), ma non viene applicato dall'implementazione DOM. Le implementazioni core di livello DOM 3 sono necessarie per riconoscere tutti i parametri definiti in questa specifica. Alcuni valori dei parametri possono essere necessari anche per essere supportati dall'implementazione. Fare riferimento alla definizione del parametro per sapere se un valore deve essere supportato o meno. <p ><b Nota:</b>> Parametri sono simili a funzionalità e proprietà usate in SAX2 [SAX].

L'elenco seguente di parametri definiti nel DOM: <dl dt/dt><dd dl<><>>true< dt"canonical-form"<>/dt<>dd>><[<em>facoltativo</em>] Canonizzare il documento in base alle regole specificate in [XML canonico], ad esempio rimuovere il DocumentType nodo (se presente) dall'albero o rimuovere dichiarazioni di spazio dei nomi superflue da ogni elemento. Si noti che questo è limitato a ciò che può essere rappresentato nel DOM; in particolare, non è possibile specificare l'ordine degli attributi nel DOM. Inoltre, impostando questo parametro true su verrà impostato anche lo stato dei parametri elencati di seguito. Le modifiche successive allo stato di uno di questi parametri restituiranno il formato "canonico" a false. Parametri impostati su false: "entità", "normal-caratteri", "cdata-sections". Parametri impostati su true: "namespaces", "namespace-declarations", "well-form", "element-content-whitespace". Altri parametri non vengono modificati a meno che non sia specificato in modo esplicito nella descrizione dei parametri.</dd dt/dt><>false< dd>><[<em>required</em>] (<em>default</em>)Non canonizzare il documento.</dd/dl/dd>< dt/dt dd<>dl><dt>"cdata-sections"true><</dt><><><> dd[<em>required</em] (<em>default</em>>)Mantieni CDATASection i nodi nel documento.<></dd dt/dt><false<> dd>><[<em required</em>>]Trasforma CDATASection i nodi nel documento in Text nodi. Il nuovo Text nodo viene quindi combinato con qualsiasi nodo adiacenteText.</dd/dl></dd>< dt/dt dd dl><dt>>"check-character-normalization"<<true/<><>dt><> dd><[em>facoltativo</em>] Controllare se i caratteri nel documento sono completamente normalizzati, come definito nell'appendice B di [<XML 1.1]. Quando viene rilevata una sequenza di caratteri che non riesce il controllo della normalizzazione, viene generato un errore con gli DOMError.type uguali a "check-character-normalization-failure". </dd dt/dt><>false< dd>><[<em>required</em>] (<em>default</em>)Non controllare se i caratteri sono normalizzati.</dd/dl/dd>< dt/dt dd<>dl><dt>"comments"true><</dt><><><> dd[<em>required</em] (<em>default</em>>)Mantieni Comment i nodi nel documento.<></dd dt/dt><false<> dd>><[<em required</em>>]Rimuovi Comment nodi nel documento.</dd/dl></dd>><< dt/dt dd dl><dt>>"datatype-normalization"<<true/<><>dt><> dd[<em>facoltativo</em>] Esporre i valori normalizzati dello schema nell'albero, ad esempio i valori normalizzati di XML Schema nel caso di XML Schema. Poiché questo parametro richiede di avere informazioni sullo schema, il parametro "validate" verrà impostato anche su true. L'attivazione di questo parametro quando "convalida" non ha false alcun effetto e non verrà eseguita alcuna normalizzazione dello schema. <p ><b Nota:</b>> Poiché il documento contiene il risultato dell'elaborazione XML 1.0, questo parametro non si applica alla normalizzazione dei valori dell'attributo come definito nella sezione 3.3.3 di [XML 1.0] ed è destinato solo ai linguaggi dello schema diversi da Definizione del tipo di documento (DTD). </dd dt/dt><false>< dd>><[<em>required</em>] (<em>default</em>) Non eseguire la normalizzazione dello schema nell'albero. </dd/dl/dd>< dt/>><<dt dd dl><dt><true"element-content-whitespace"></dt>>< dd><[<em>required</em] (<em>default</em>>)Mantieni tutti gli spazi vuoti nel documento.<></dd dt/dt><false<> dd>><[<em>facoltativo</em>] Eliminare tutti i Text nodi che contengono spazi vuoti nel contenuto dell'elemento, come descritto in [spazio vuoto contenuto elemento]. È previsto che l'implementazione usi l'attributo Text.isElementContentWhitespace per determinare se un Text nodo deve essere rimosso o meno.</dd/dl/dd>< dt/dt dd<>dl><dt>"entities"true><</dt><><><> dd[<em>required</em] (<em>default</em>>)Mantieni EntityReference i nodi nel documento.<></dd dt/dt><false<> dd>><[<em required</em>>] Rimuovere tutti i EntityReference nodi dal documento, inserendo le espansioni dell'entità direttamente al loro posto. Text i nodi vengono normalizzati, come definito in Node.normalize. Nel documento vengono mantenuti solo i riferimenti alle entità non crittografati . </dd></dl><p ><b Nota:</b>> Questo parametro non influisce sui Entity nodi. </dd dt/dt><"error-handler"<> dd>><[<em required</em>>] Contiene un DOMErrorHandler oggetto. Se si verifica un errore nel documento, l'implementazione restituirà il DOMErrorHandler valore registrato usando questo parametro. L'implementazione può fornire un oggetto predefinito DOMErrorHandler . Quando viene chiamato, DOMError.relatedData conterrà il nodo più vicino a dove si è verificato l'errore. Se l'implementazione non è in grado di determinare il nodo in cui si verifica l'errore, DOMError.relatedData conterrà il Document nodo. Le mutazioni nel documento dall'interno di un gestore degli errori comportano un comportamento dipendente dall'implementazione. </dd><dt/dt dd dl><dt>true</dt>"infoset"><< dd<>[<em required</<>>em>>]Keep nel documento le informazioni definite nel set di informazioni XML [XML Information Set] . Questo forza i parametri seguenti a false: "validate-if-schema", "entityes", "datatype-normalization", "cdata-sections". In questo modo i parametri seguenti vengono forzati in true: " namespace-declarations", "well-form", "element-content-whitespace", " comments", "namespaces". Altri parametri non vengono modificati a meno che non sia specificato in modo esplicito nella descrizione dei parametri. Si noti che l'esecuzione di query su questo parametro con getParameter restituisce true solo se i singoli parametri specificati in precedenza sono impostati in modo appropriato.</dd><dt/dt<false> dd>><Impostazione infoset per false non ha alcun effetto.</dd/dl></dd<> dt/><><dt dd dl><dt><true/dt>"namespaces">><< dd<>[<em required</em] (<em>>default</em>>) Eseguire l'elaborazione dello spazio dei nomi come definito in . </dd dt/dt><<false> dd>><[<em>facoltativo</em>] Non eseguire l'elaborazione dello spazio dei nomi. </dd/dl/dd>< dt/dt>"namespace-declarations"><>< dd><Questo parametro non ha alcun effetto se il parametro "namespaces" è impostato su .false>< <dl><dt/dt<>true dd><>[<em required</em] (<em>>default</>em>) Includi attributi di dichiarazione dello spazio dei nomi, specificati o predefiniti dallo schema, nel documento. Vedere anche le sezioni "Dichiarazione di spazi dei nomi" in [spazi dei nomi XML] e [spazi dei nomi XML 1.1] .</dd><dt/dt>false><< dd>[<em required</em>>]Eliminare tutti gli attributi di dichiarazione dello spazio dei nomi. I prefissi dello spazio dei nomi ( Node.prefix) vengono conservati anche se questo parametro è impostato su false.</dd/dl></dd>< dt/dt dd<>dl><dt>true</<<>>dt>>"normalize-characters"<>< dd[em>facoltativo</em>] Completamente normalizzato i caratteri nel documento come definito nell'appendice B di [<XML 1.1]. </dd dt/dt><><false dd>><[<em required</em>] (<em>>default</em>)Non eseguire la normalizzazione dei caratteri.</dd/dl></dd>><< dt><> dd<"schema-location">[em>facoltativo</em>] Rappresentare un oggetto contenente un DOMString elenco di URI, separati da spazi vuoti (caratteri corrispondenti alla produzione nonterminale definita nella sezione 2.3 [<XML 1.0]), che rappresenta gli schemi rispetto ai quali deve verificarsi la convalida, ovvero lo schema corrente. I tipi di schemi a cui si fa riferimento in questo elenco devono corrispondere al tipo specificato con schema-type, in caso contrario, il comportamento di un'implementazione non è definito. Gli schemi specificati usando questa proprietà hanno la precedenza sulle informazioni sullo schema specificate nel documento stesso. Per lo schema con riconoscimento dello spazio dei nomi, se uno schema specificato usando questa proprietà e uno schema specificato nell'istanza del documento (ad esempio usando l'attributo schemaLocation ) in un documento dello schema (ad esempio import usando i meccanismi dello schema) condividono lo stesso targetNamespaceschema specificato dall'utente usando questa proprietà. Se due schemi specificati usando questa proprietà condividono lo stesso targetNamespace o non hanno spazio dei nomi, il comportamento dipende dall'implementazione. Se non è stata fornita alcuna posizione, questo parametro è null. <p ><b Nota:</b>> Il "schema-location" parametro viene ignorato a meno che non sia impostato il valore del parametro "schema-type". È consigliabile Document.documentURI impostare un'implementazione in modo che un'implementazione possa risolvere correttamente eventuali entità esterne a cui fa riferimento. </dd><dt/dt>"schema-type"<<> dd>[<em>facoltativo</em>] Rappresenta un oggetto contenente un DOMString URI assoluto e rappresenta il tipo del linguaggio dello schema usato per convalidare un documento. Si noti che non viene eseguito alcun controllo lessicale sull'URI assoluto. Se questo parametro non è impostato, un valore predefinito può essere fornito dall'implementazione, in base ai linguaggi dello schema supportati e al linguaggio dello schema usato in fase di caricamento. Se non viene specificato alcun valore, questo parametro è null. <p ><b Nota:</b>> Per XML Schema [XML Schema Part 1] , le applicazioni devono usare il valore "http://www.w3.org/2001/XMLSchema". Per XML DTD [XML 1.0], le applicazioni devono usare il valore "http://www.w3.org/TR/REC-xml". Altri linguaggi dello schema non rientrano nell'ambito del W3C e pertanto consigliano un URI assoluto per usare questo metodo. </dd><dt/dt dd dl><dt><true/><>dt>"split-cdata-sections"<<> dd><[<em required</>em] (<em>>default</em>)Split CDATA section marker ']]>'. Quando una sezione CDATA viene suddivisa, viene generato un avviso con un DOMError.type valore uguale a "cdata-sections-splitted" e DOMError.relatedData uguale al primo CDATASection nodo nell'ordine di documento risultante dalla divisione.</dd dt/dt><false<> dd>><[<em required</em>>]Segnala un errore se un CDATASection oggetto contiene un carattere non rappresentabile.</dd/dl></dd<> dt/dt dd<>dl><dt>true</><<>dt>><<"validate"> dd[<em>facoltativo</em>] Richiedi la convalida su uno schema (i.e. XML schema, DTD, qualsiasi altro tipo o rappresentazione dello schema) del documento come viene normalizzato come definito da [XML 1.0]. Se vengono trovati errori di convalida o non è stato trovato alcun schema, il gestore degli errori riceve una notifica. I valori normalizzati dallo schema non verranno esposti in base allo schema usato a meno che il parametro "normalizzazione del tipo di dati" non sia true. Questo parametro rivaluta i nodi dell'attributo ul>li con uguale a false, come specificato nella descrizione dell'interfacciaAttr; <Attr.specified><</li li><> Il valore dell'attributo Text.isElementContentWhitespace per tutti i Text nodi; </li li><> Il valore dell'attributo Attr.isId per tutti i Attr nodi; </li li>>< Gli attributi Element.schemaTypeInfo e Attr.schemaTypeInfo. </li></ul><p ><b Note:</b>> "validate-if-schema" e "validate" si escludono a vicenda, impostando uno di essi per true impostare l'altro su false. Le applicazioni devono anche considerare l'impostazione del parametro "ben formato" su true, ovvero l'impostazione predefinita per tale opzione, quando si convalida il documento. </dd dt/dt><false>< dd>><[<em>required</em>] (<em>default</em>) Non eseguire l'elaborazione dello schema, inclusa l'elaborazione interna del subset. Le informazioni sui valori degli attributi predefiniti vengono mantenute. Si noti che la convalida potrebbe verificarsi ancora se "validate-if-schema" è true . </dd/dl/dd>< dt/dt dd><dl><dt><>"validate-if-schema"<true/>><<dt>>< dd[<em>facoltativo</em>]Abilitare la convalida solo se una dichiarazione per l'elemento documento può essere trovata in uno schema (indipendentemente dalla posizione in cui si trova, i.e. XML schema, DTD o qualsiasi altro tipo o rappresentazione dello schema).>< Se la convalida è abilitata, questo parametro ha lo stesso comportamento del parametro "validate" impostato su true. <p ><b Nota:</b>> "validate-if-schema" e "validate" si escludono a vicenda, impostandone uno per true impostare l'altro su false. </dd><dt/dt><<>false dd>[<em>required</em] (<em>default</>em>) Nessuna elaborazione dello schema deve essere eseguita se il documento ha uno schema, inclusa l'elaborazione interna del subset. Le informazioni sui valori degli attributi predefiniti vengono mantenute. Si noti che la convalida deve comunque verificarsi se "convalida" è true. </dd/dl></dd<> dt/dt dd><dl><dt><true/dt><"well-formed"><>>><< dd[<em>required</em>] (<em>default</>em) Controllare se tutti i nodi sono ben formati in base alla versione XML in uso in Document.xmlVersion: <ul><li> check se l'attributo Node.nodeName contiene caratteri non validi in base al relativo tipo di nodo e generare un oggetto di tipo "wf-invalid-character-in-node-name", con gravità DOMErrorDOMError.SEVERITY_ERROR, se necessario; </li><> controllare se il contenuto di testo all'interno Attrdi , CommentTextnodi CDATASection per caratteri non validi e generare un di tipo "wf-invalid-character", Elementcon gravità DOMErrorDOMError.SEVERITY_ERROR, se necessario; </li>>< controlla se i dati all'interno ProcessingInstruction dei nodi per i caratteri non validi e generano un tipo "wf-invalid-character", con gravità DOMErrorDOMError.SEVERITY_ERROR, se necessario; </li>/ul></dd dt/dt><false<> dd>><[<em>facoltativo</em>] Non verificare la forma corretta XML.< </dd/dl/dd><<>/dl><>

La risoluzione degli identificatori di sistema associati alle entità viene eseguita usando Document.documentURI. Tuttavia, quando la funzionalità "LS" definita in [CARICO DOM 3 Load and Save] è supportata dall'implementazione DOM, il parametro "resource-resolver" può essere usato anche sugli DOMConfiguration oggetti collegati ai Document nodi. Se questo parametro è impostato, Document.normalizeDocument() richiama il resolver della risorsa anziché usare Document.documentURI.

Vedere anche la specifica DOM (Document Object Model) Level 3 Core.

Aggiunta in DOM Level 3.

Documentazione Java per org.w3c.dom.DOMConfiguration.

Le parti di questa pagina sono modifiche in base al lavoro creato e condiviso dal Android Open Source e usato in base ai termini descritti nella .

Proprietà

Handle	Ottiene il valore JNI dell'oggetto Android sottostante. (Ereditato da IJavaObject)
JniIdentityHashCode	Restituisce il valore di per java.lang.System.identityHashCode() l'istanza di wrapped. (Ereditato da IJavaPeerable)
JniManagedPeerState	Stato del peer gestito. (Ereditato da IJavaPeerable)
JniPeerMembers	Supporto per l'accesso ai membri e la chiamata. (Ereditato da IJavaPeerable)
ParameterNames	Elenco dei parametri supportati da questo DOMConfiguration oggetto e per il quale è possibile impostare almeno un valore dall'applicazione.
PeerReference	Restituisce un'istanza JniObjectReference dell'oggetto Java con wrapping. (Ereditato da IJavaPeerable)

Metodi

CanSetParameter(String, Object)	Verificare se è supportata l'impostazione di un parametro su un valore specifico.
Disposed()	Chiamato quando l'istanza è stata eliminata. (Ereditato da IJavaPeerable)
DisposeUnlessReferenced()	Se non sono presenti riferimenti in sospeso a questa istanza, chiama Dispose(); in caso contrario, non fa nulla. (Ereditato da IJavaPeerable)
Finalized()	Chiamato quando l'istanza è stata finalizzata. (Ereditato da IJavaPeerable)
GetParameter(String)	Restituisce il valore di un parametro se noto.
SetJniIdentityHashCode(Int32)	Impostare il valore restituito da JniIdentityHashCode. (Ereditato da IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	L'interfaccia DOMConfiguration rappresenta la configurazione di un documento e gestisce una tabella di parametri riconosciuti. (Ereditato da IJavaPeerable)
SetParameter(String, Object)	Impostare il valore di un parametro.
SetPeerReference(JniObjectReference)	Impostare il valore restituito da PeerReference. (Ereditato da IJavaPeerable)
UnregisterFromRuntime()	Annullare la registrazione di questa istanza in modo che il runtime non lo restituirà dalle chiamate future Java.Interop.JniRuntime+JniValueManager.PeekValue . (Ereditato da IJavaPeerable)

Metodi di estensione

JavaCast<TResult>(IJavaObject)	Esegue una conversione dei tipi controllati dal runtime Android.
JavaCast<TResult>(IJavaObject)	L'interfaccia DOMConfiguration rappresenta la configurazione di un documento e gestisce una tabella di parametri riconosciuti.
GetJniTypeName(IJavaPeerable)	L'interfaccia DOMConfiguration rappresenta la configurazione di un documento e gestisce una tabella di parametri riconosciuti.