IDOMConfiguration Interfaccia

Riferimento

Definizione

Spazio dei nomi:: Org.W3c.Dom

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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 di Document . DOMConfiguration gli oggetti vengono usati anche in [DOM Level 3 Load and Save] nelle DOMParser interfacce e DOMSerializer .

I nomi dei parametri usati dall'oggetto DOMConfiguration vengono definiti in tutte le specifiche DOM Level 3. Per i nomi viene fatta distinzione tra maiuscole e minuscole. Per evitare possibili conflitti, 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à in , i nomi sono consigliati per seguire la sezione 5.16 Identificatori di [Unicode] con l'aggiunta del carattere '-' (HYPHEN-MINUS), ma non viene applicato dall'implementazione DOM. Le implementazioni di base del livello DOM 3 sono necessarie per riconoscere tutti i parametri definiti in questa specifica. Alcuni valori di parametro possono anche essere necessari per essere supportati dall'implementazione. Fare riferimento alla definizione del parametro per sapere se un valore deve essere supportato o meno. > Parametri sono simili alle caratteristiche e alle proprietà usate in SAX2 [SAX].

L'elenco seguente di parametri definiti nel DOM: <dl><dt<"canonical-form">/dt<>dd><dl<>dt/dttrue>><< dd>[optional] Canonizza il documento in base alle regole specificate in [XML canonico], ad esempio rimuovendo il DocumentType nodo (se presente) dall'albero o rimuovendo 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, l'impostazione di questo parametro su true imposta anche lo stato dei parametri elencati di seguito. Le modifiche successive allo stato di uno di questi parametri ripristinano "formato canonico" in false. Parametri impostati su false: "entities", " normalize-characters", "cdata-sections". Parametri impostati su true: "namespaces", "namespace-declarations", "well-formed", "element-content-whitespace". Gli altri parametri non vengono modificati a meno che non vengano specificati in modo esplicito nella descrizione dei parametri.</dd><dt/dt>false><< dd>[required] (default)Non canonizzare il documento.</dd></dl></dd><dt><"cdata-sections"/dt><dd><dl><dt><true/dt><dd>[required] (default)Mantieni CDATASection nodi nel documento.</dd><dt/dt><>false< dd>[required]Trasforma CDATASection i nodi nel documento in Text nodi. Il nuovo Text nodo viene quindi combinato con qualsiasi nodo adiacente Text .</dd></dl></dd><dt>"check-character-normalization"</dt><dd><dl><dt>true</dt><dd>[optional] 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 supera il controllo della normalizzazione, viene generato un errore con uguale DOMError.type a "check-character-normalization-failure". </dd><dt/dt>false><< dd>[required] (default)Non controllare se i caratteri sono normalizzati.</dd></dl></dd><dt><"comments"/dt><dd><dl><dt><true/dt><dd>[required] (default)Mantieni Comment nodi nel documento.</dd><dt/dt><>false< dd>[required]Discard Comment nodes in the document.</dd/dl></dd><dt/dt>>"datatype-normalization"<< dd><dl><dt>true</dt><dd>[optional] Esporre valori normalizzati dello schema nell'albero, ad esempio valori normalizzati di XML Schema nel caso di XML Schema.>< Poiché questo parametro richiede di avere informazioni sullo schema, anche il parametro "validate" verrà impostato su true. L'attivazione di questo parametro quando "validate" non ha false alcun effetto e non si verificherà alcuna normalizzazione dello schema. > Poiché il documento contiene il risultato dell'elaborazione XML 1.0, questo parametro non si applica alla normalizzazione dei valori di attributo come definito nella sezione 3.3.3 di [XML 1.0] ed è destinato solo a linguaggi dello schema diversi da DTD (Document Type Definition). </dd><dt/dt><<>false dd>[required] (default) Non eseguire la normalizzazione dello schema nell'albero. </dd></dl></dd><dt><"element-content-whitespace"/dt><dd><dl><dt><true/dt><dd>[required</em] (default>)Mantieni tutti gli spazi vuoti nel documento.</dd><dt/dt><><false dd>[optional] Ignora 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><"entities"/dt><dd><dl><dt><true/dt><dd>[required] (default)Mantieni EntityReference nodi nel documento.</dd><dt/dt>false<<> dd>[required] 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 conservati solo i riferimenti di entità non espansi . </dd></dl>Nota: Questo parametro non influisce sui Entity nodi. </dd><dt/dt>"error-handler"<<> dd>[required] contiene un DOMErrorHandler oggetto . Se si verifica un errore nel documento, l'implementazione richiamerà il DOMErrorHandler 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 errori genereranno un comportamento dipendente dall'implementazione. </dd><dt/dt>"infoset"<>< dd><dl><dt/dt><true>< dd>[required]Keep in the document the information defined in the XML Information Set [XML Information Set] . In questo modo i parametri seguenti vengono forzati in false: " validate-if-schema", "entities", "datatype-normalization", "cdata-sections". In questo modo i parametri seguenti vengono forzati su true: " namespace-declarations", "well-formed", "element-content-whitespace", " comments", "namespaces". Gli altri parametri non vengono modificati a meno che non vengano specificati 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 su false non ha alcun effetto.</dd></dl></dd><dt>"namespaces"</dt><dd><dl><dt>true</dt><dd>[required</em] (default>) Eseguire l'elaborazione dello spazio dei nomi come definito in . </dd><dt/dt><><false dd>[optional] 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>[required] (default) 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>[required]Discard all namespace declaration attributes. I prefissi dello spazio dei nomi ( Node.prefix) vengono mantenuti anche se questo parametro è impostato su false.</dd></dl></dd><dt>"normalize-characters"</dt><dd><dl><dt><true/dt><dd>[optional] Completamente normalizzato i caratteri nel documento come definito nell'appendice B di [XML 1.1]. </dd><dt/dt>false><< dd>[required] (default)Non eseguire la normalizzazione dei caratteri.</dd></dl></dd><dt/dt>"schema-location"><< dd>[optional] Rappresenta un DOMString oggetto contenente un elenco di URI, separati da spazi vuoti (caratteri corrispondenti alla produzione non deterministica definita nella sezione 2.3 [XML 1.0]), che rappresenta gli schemi in base ai quali deve verificarsi la convalida, ovvero lo schema corrente. I tipi di schemi a cui viene fatto 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 utilizzando questa proprietà hanno la precedenza sulle informazioni sullo schema specificate nel documento stesso. Per lo schema compatibile con lo spazio dei nomi, se uno schema specificato utilizzando questa proprietà e uno schema specificato nell'istanza del documento ,ad esempio usando l'attributo schemaLocation , in un documento dello schema (ad esempio tramite meccanismi di schema import ) condividono lo stesso targetNamespace, verrà usato lo schema specificato dall'utente che usa questa proprietà. Se due schemi specificati usando questa proprietà condividono lo stesso targetNamespace o non hanno uno spazio dei nomi, il comportamento dipende dall'implementazione. Se non è stata specificata alcuna posizione, questo parametro è null. > Il "schema-location" parametro viene ignorato a meno che non sia impostato il valore del parametro "schema-type". È consigliabile impostare in modo che Document.documentURI un'implementazione possa risolvere correttamente tutte le entità esterne a cui viene fatto riferimento. </dd><dt/dt>"schema-type"<<> dd>[optional] Rappresenta un DOMString oggetto contenente un 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, è possibile specificare un valore predefinito dall'implementazione, in base ai linguaggi di schema supportati e al linguaggio di schema usato in fase di caricamento. Se non viene specificato alcun valore, questo parametro è null. > Per XML Schema [XML Schema Parte 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 di W3C e pertanto consigliano un URI assoluto per usare questo metodo. </dd><dt/dt><"split-cdata-sections">< dd><dl><dt/dt>>true<< dd>[required] (default)Split CDATA sections contenente il marcatore di terminazione della sezione CDATA ']]>'. Quando una sezione CDATA viene divisa, viene generato un avviso con un DOMError.type valore uguale a "cdata-sections-splitted" e DOMError.relatedData uguale al primo CDATASection nodo nell'ordine dei documenti risultante dalla divisione.</dd><dt/dt><>false< dd>[required]Segnala un errore se contiene CDATASection un carattere non rappresentabile.</dd/dl></dd><dt><"validate"/dt><dd><dl><dt><true/dt><dd>[optional] Richiedi la convalida su uno schema (schema i.e. XML, DTD, qualsiasi altro tipo o rappresentazione dello schema) del documento in quanto viene normalizzato come definito da [XML 1.0].>< Se vengono rilevati errori di convalida o non è stato trovato alcuno 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 "datatype-normalization" non sia true. Questo parametro rivaluta: ul>li Attribute nodes with Attr.specified equals to false, come specificato nella descrizione dell'interfacciaAttr; <><</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>>< Nota: "validate-if-schema" e "validate" si escludono a vicenda, impostando uno di essi su true impostando l'altro su false. Le applicazioni devono anche prendere in considerazione 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>[required] (default) 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 comunque verificarsi se "validate-if-schema" è true . </dd></dl></dd><dt><"validate-if-schema"/dt><dd><dl><dt><true/dt><dd>[optional]Enable validation only if a declaration for the document element can be found in a schema (independently of where it is found, i.e. XML schema, DTD, or any other type or representation of schema). Se la convalida è abilitata, questo parametro ha lo stesso comportamento del parametro "validate" impostato su true. > "validate-if-schema" e "validate" si escludono a vicenda, impostando uno di essi su true impostando l'altro su false. </dd><dt/dt><<>false dd>[required] (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 "validate" è true. </dd></dl></dd><dt>"well-formed"</dt><dd><dl><dt>true</dt><dd>[required</em] (default>) Verificare se tutti i nodi sono in formato XML in base alla versione XML in uso in Document.xmlVersion: <ul><li> controllare se l'attributo Node.nodeName contiene caratteri non validi in base al tipo di nodo e generare un DOMError di tipo "wf-invalid-character-in-node-name", con gravitàDOMError.SEVERITY_ERROR, se necessario; </li><controllare> se il contenuto del testo all'interno Attrdi , ElementComment, Text, , CDATASection nodi per i caratteri non validi e generare un DOMError di tipo "wf-invalid-character", con gravitàDOMError.SEVERITY_ERROR, se necessario; </li><controllare> se i dati all'interno ProcessingInstruction dei nodi per i caratteri non validi e generare un DOMError di tipo "wf-invalid-character", con gravitàDOMError.SEVERITY_ERROR, se necessario; </li>/ul></dd><dt/dt><<>false dd>[optional] Non verificare la correttezza 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 [DOM Level 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() richiamerà il sistema di risoluzione delle risorse invece di usare Document.documentURI.

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

Aggiunta in DOM Livello 3.

Documentazione java per org.w3c.dom.DOMConfiguration.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Proprietà

Handle	Ottiene il valore JNI dell'oggetto Android sottostante. (Ereditato da IJavaObject)
JniIdentityHashCode	Restituisce il valore di `java.lang.System.identityHashCode()` per l'istanza di cui è stato eseguito il wrapping. (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 cui è possibile impostare almeno un valore dall'applicazione.
PeerReference	Restituisce un JniObjectReference oggetto dell'istanza dell'oggetto Java di cui è stato eseguito il wrapping. (Ereditato da IJavaPeerable)

Metodi

CanSetParameter(String, Object)	Controllare 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 esegue alcuna operazione. (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 restituisca dalle chiamate future Java.Interop.JniRuntime+JniValueManager.PeekValue . (Ereditato da IJavaPeerable)

Metodi di estensione

JavaCast<TResult>(IJavaObject)	Esegue una conversione del tipo di tipo controllato 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.

Si applica a

Condividi tramite