IDOMConfiguration Interface

Référence

Définition

Espace de noms:: Org.W3c.Dom

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

L’interface DOMConfiguration représente la configuration d’un document et gère une table des paramètres reconnus.

[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

Attributs: RegisterAttribute

Implémente: IJavaObject IJavaPeerable IDisposable

Remarques

L’interface DOMConfiguration représente la configuration d’un document et gère une table des paramètres reconnus. À l’aide de la configuration, il est possible de modifier Document.normalizeDocument() le comportement, par exemple en remplaçant les CDATASection nœuds par des nœuds Text ou en spécifiant le type du schéma qui doit être utilisé lors de la validation de l’objet Document demandé. DOMConfigurationles objets sont également utilisés dans [Chargement et enregistrement DOM Niveau 3] dans les interfaces et DOMSerializer les DOMParser interfaces.

Les noms de paramètres utilisés par l’objet DOMConfiguration sont définis dans les spécifications DOM Level 3. Les noms sont sensibles à la casse. Pour éviter les conflits possibles, en tant que convention, les noms faisant référence aux paramètres définis en dehors de la spécification DOM doivent être rendus uniques. Étant donné que les paramètres sont exposés en tant que propriétés dans le fichier , les noms sont recommandés pour suivre les identificateurs de la section 5.16 de [Unicode] avec l’ajout du caractère « - » (HYPHEN-MINUS), mais il n’est pas appliqué par l’implémentation DOM. Les implémentations principales de niveau DOM 3 sont requises pour reconnaître tous les paramètres définis dans cette spécification. Certaines valeurs de paramètre peuvent également être requises pour être prises en charge par l’implémentation. Reportez-vous à la définition du paramètre pour savoir si une valeur doit être prise en charge ou non. Remarque : Les paramètres sont similaires aux fonctionnalités et propriétés utilisées dans SAX2 [SAX].

La liste suivante des paramètres définis dans le DOM : <dl><dt>"canonical-form"</dt>><<dl dl dt<>dt><true dt<>dd>[optional] Canonicalize le document en fonction des règles spécifiées dans [XML canonique], telles que la suppression du DocumentType nœud (le cas échéant) de l’arborescence ou la suppression de déclarations d’espace de noms superflues de chaque élément. Notez que cela est limité à ce qui peut être représenté dans le DOM ; en particulier, il n’existe aucun moyen de spécifier l’ordre des attributs dans le DOM. En outre, la définition de ce paramètre true pour définira également l’état des paramètres répertoriés ci-dessous. Les modifications ultérieures apportées à l’état de l’un de ces paramètres rétabliront la valeur « canonique-form ».false Paramètres définis sur false: « entities », « normalize-characters », « cdata-sections ». Paramètres définis sur true: « namespaces », « namespace-declarations », « well-form », « element-content-whitespace ». Les autres paramètres ne sont pas modifiés, sauf indication explicite dans la description des paramètres.</dd><dt/dt><<false> dd>[required</em] (> default)Ne canoniquez pas le document.</dd></dl></dd><dt><"cdata-sections"/dt><<>dl dl><dt>true</dt><dd>[required] (default)Conserver CDATASection les nœuds dans le document.</dd><dt/dt><>false< dd>[required]Transformer CDATASection des nœuds dans le document en Text nœuds. Le nouveau Text nœud est ensuite combiné à n’importe quel nœud adjacentText.</dd></dl></dd><dt>"check-character-normalization"</dt><<>dl dl><dt/dt>><<true dd>[optional] Vérifiez si les caractères du document sont entièrement normalisés, comme défini dans l’annexe B de [XML 1.1]. Lorsqu’une séquence de caractères est rencontrée qui échoue à la vérification de la normalisation, une erreur avec les DOMError.type égaux à « check-character-normalization-failure » est émise. </dd><dt/dt>false><< dd>[required</em] (default>)Ne vérifiez pas si les caractères sont normalisés.</dd></dl></dd><dt><"comments"/dt><<>dl dl><dt>true</dt><dd>[required] (default)Conserver Comment les nœuds dans le document.</dd><dt/dt><>false< dd>[required]Ignorer les Comment nœuds dans le document.</dd></dl></dd><dt><"datatype-normalization"/<<>>dt dl dl><dt/dt><true>< dd>[optional] Expose les valeurs normalisées de schéma dans l’arborescence, telles que les valeurs normalisées de schéma XML dans le cas du schéma XML. Étant donné que ce paramètre nécessite d’avoir des informations de schéma, le paramètre « validate » est également défini sur true. Le fait que ce paramètre soit activé lorsque la « validation » n’a false aucun effet et qu’aucune normalisation de schéma ne se produit. Remarque : Étant donné que le document contient le résultat du traitement XML 1.0, ce paramètre ne s’applique pas à la normalisation des valeurs d’attribut comme défini dans la section 3.3.3 de [XML 1.0] et est destiné uniquement aux langages de schéma autres que la définition de type de document (DTD). </dd><dt/dt>false><< dd>[required</em] (> default) Ne pas effectuer de normalisation de schéma sur l’arborescence. </dd></dl></dd><dt><"element-content-whitespace"/dt><><dl dl><dt>true</dt><dd>[required] (default)Conservez tous les espaces blancs dans le document.</dd><dt/dt><><false dd>[optional] Ignorer tous les Text nœuds qui contiennent des espaces blancs dans le contenu de l’élément, comme décrit dans [espace blanc du contenu de l’élément]. L’implémentation est censée utiliser l’attribut Text.isElementContentWhitespace pour déterminer si un Text nœud doit être ignoré ou non.</dd></dl></dd><dt><"entities"/dt><<>dl dl><dt>true</dt><dd>[required] (default)Conserver EntityReference les nœuds dans le document.</dd><dt/dt>false<<> dd>[required] Supprime tous les EntityReference nœuds du document, en plaçant les extensions d’entité directement à leur place. Text les nœuds sont normalisés, comme défini dans Node.normalize. Seules les références d’entité non expirées sont conservées dans le document. </dd></dl>Remarque : Ce paramètre n’affecte pas les Entity nœuds. </dd><dt/dt>"error-handler"<<> dd>[required] Contient un DOMErrorHandler objet. Si une erreur se produit dans le document, l’implémentation rappelle l’inscription à l’aide DOMErrorHandler de ce paramètre. L’implémentation peut fournir un objet par défaut DOMErrorHandler . Lorsqu’elle est appelée, DOMError.relatedData contient le nœud le plus proche de l’endroit où l’erreur s’est produite. Si l’implémentation ne peut pas déterminer le nœud où l’erreur se produit, DOMError.relatedData contient le Document nœud. Les mutations vers le document à partir d’un gestionnaire d’erreurs entraînent un comportement dépendant de l’implémentation. </dd><dt/dt>"infoset"<<> dl><dt><dt>><true< dd>[required]Conserver dans le document les informations définies dans le jeu d’informations XML [jeu d’informations XML] . Cela force les paramètres suivants à false: « validate-if-schema », « entities », « datatype-normalization », « cdata-sections ». Cela force les paramètres suivants à true: « namespace-declarations », « well-form », « element-content-whitespace », « comments », « namespaces ». Les autres paramètres ne sont pas modifiés, sauf indication explicite dans la description des paramètres. Notez que l’interrogation de ce paramètre avec getParameter des retours true uniquement si les paramètres individuels spécifiés ci-dessus sont correctement définis.<Le paramètre /dd><dt/dt<>dd<false>> n’a false aucun effet.<infoset/dd></dl></dd><dt><"namespaces"/dt><<>dl dl><dt>true</dt><dd>[required] (default) Effectuez le traitement de l’espace de noms tel que défini dans . </dd><dt/dt><><false dd>[optional] N’effectuez pas le traitement de l’espace de noms. </dd></dl/dd><>< dt/dt><"namespace-declarations"<> dd> Ce paramètre n’a aucun effet si le paramètre « namespaces » est défini falsesur . <dl><dt/dt>true><< dd>[required</em] (> default/em>) Incluez les attributs de déclaration d’espace de noms<, spécifiés ou par défaut à partir du schéma, dans le document. Consultez également les sections « Déclaration des espaces de noms » dans [Espaces de noms XML] et [Espaces de noms XML 1.1] .</dd><dt/dt><><false dd>[required]Ignorer tous les attributs de déclaration d’espace de noms. Les préfixes d’espace de noms (Node.prefix) sont conservés même si ce paramètre est défini sur false.</dd></dl></dd><dt>"normalize-characters"</dt><<>dl dl><dt/dt>><<true dd>[optional] Normalise entièrement les caractères du document comme défini dans l’annexe B de [XML 1.1]. </dd><dt/dt><<false> dd>[required</em] (> default)Ne pas effectuer de normalisation des caractères.</dd/dl/dt>< dt>"schema-location"< dd><>><[optional] Représente un objet contenant une DOMString liste d’URI, séparés par des espaces blancs (caractères correspondant au S de production non déterministe défini dans la section 2.3 [XML 1.0]), qui représente les schémas sur lesquels la validation doit se produire, c’est-à-dire le schéma actuel.>< Les types de schémas référencés dans cette liste doivent correspondre au type spécifié avec schema-type, sinon le comportement d’une implémentation n’est pas défini. Les schémas spécifiés à l’aide de cette propriété sont prioritaires sur les informations de schéma spécifiées dans le document lui-même. Pour le schéma prenant en charge l’espace de noms, si un schéma spécifié à l’aide de cette propriété et d’un schéma spécifié dans l’instance de document de document de document (c’est-à-dire l’utilisation de l’attribut schemaLocation ) dans un document de schéma (c’est-à-dire à l’aide de mécanismes de schéma import ) partage le même targetNamespace, le schéma spécifié par l’utilisateur à l’aide de cette propriété sera utilisé. Si deux schémas spécifiés à l’aide de cette propriété partagent le même targetNamespace ou n’ont pas d’espace de noms, le comportement dépend de l’implémentation. Si aucun emplacement n’a été fourni, ce paramètre est null. Remarque : Le "schema-location" paramètre est ignoré, sauf si la valeur du paramètre « schema-type » est définie. Il est fortement recommandé de Document.documentURI définir une implémentation afin qu’une implémentation puisse résoudre correctement toutes les entités externes référencées. </dd><dt/dt>"schema-type"<<> dd>[optional] Représente un objet contenant un DOMString URI absolu et représentant le type du langage de schéma utilisé pour valider un document. Notez qu’aucune vérification lexicale n’est effectuée sur l’URI absolu. Si ce paramètre n’est pas défini, une valeur par défaut peut être fournie par l’implémentation, en fonction des langages de schéma pris en charge et du langage de schéma utilisé au moment du chargement. Si aucune valeur n’est fournie, ce paramètre est null. Remarque : Pour le schéma XML [XML Schema Part 1] , les applications doivent utiliser la valeur "http://www.w3.org/2001/XMLSchema". Pour XML DTD [XML 1.0], les applications doivent utiliser la valeur "http://www.w3.org/TR/REC-xml". D’autres langages de schéma sont en dehors de l’étendue du W3C et doivent donc recommander un URI absolu pour utiliser cette méthode. </dd><dt/dt><>"split-cdata-sections"< dl><dl><dt>true<>< dd>[required</em] (default>)Fractionner les sections CDATA contenant le marqueur d’arrêt de section CDATA ']>'. Lorsqu’une section CDATA est fractionnée, un avertissement est émis avec un DOMError.type égal à "cdata-sections-splitted" et DOMError.relatedData égal au premier CDATASection nœud dans l’ordre de document résultant du fractionnement.</dd><dt/dt><>false< dd>[required]Signalez une erreur s’il CDATASection contient un caractère non réprésentable.</dd></dl/dd><>< dt><"validate"/<><>dt dl dl><dt/dt><true>< dd>[optional] Exiger la validation par rapport à un schéma (schéma i.e. XML, DTD, tout autre type ou représentation du schéma) du document tel qu’il est normalisé comme défini par [XML 1.0]. Si des erreurs de validation sont détectées ou qu’aucun schéma n’a été trouvé, le gestionnaire d’erreurs est averti. Les valeurs normalisées de schéma ne seront pas exposées en fonction du schéma utilisé, sauf si le paramètre « datatype-normalization » est true. Ce paramètre réévalue : <les nœuds d’attribut ul<>li> avec Attr.specified des valeurs égales à false, comme spécifié dans la description de l’interface ; <Attr/li li>>< La valeur de l’attribut Text.isElementContentWhitespace pour tous les Text nœuds ; </li li>>< La valeur de l’attribut Attr.isId pour tous les Attr nœuds ; </li li>>< Les attributs Element.schemaTypeInfo et Attr.schemaTypeInfo. </li></ul>Remarque : « validate-if-schema » et « validate » sont mutuellement exclusifs, en définissant l’un d’eux sur true lequel définir l’autre sur false. Les applications doivent également envisager de définir le paramètre « bien formé » truesur , qui est la valeur par défaut de cette option, lors de la validation du document. </dd><dt/dt>false><< dd>[required</em] (> default) Ne pas accomplir le traitement du schéma, y compris le traitement interne du sous-ensemble. Les informations sur les valeurs d’attribut par défaut sont conservées. Notez que la validation peut toujours se produire si « validate-if-schema » est true . </dd></dl/dd>><< dt><"validate-if-schema"/><><dt dl dl><dt/dt><><true dd>[optional]Activer la validation uniquement si une déclaration pour l’élément de document est disponible dans un schéma (indépendamment de l’emplacement où il est trouvé, i.e. XML schéma, DTD ou tout autre type ou représentation du schéma). Si la validation est activée, ce paramètre a le même comportement que le paramètre « validate » défini sur true. Remarque : « validate-if-schema » et « validate » sont mutuellement exclusifs, en définissant l’un d’eux sur true lequel définir l’autre sur false. </dd><dt/dt><<>false dd>[required</em] (default>) Aucun traitement de schéma ne doit être effectué si le document a un schéma, y compris le traitement interne du sous-ensemble. Les informations sur les valeurs d’attribut par défaut sont conservées. Notez que la validation doit toujours se produire si « valider » est true. </dd/dl/dd><>< dt><"well-formed"<>>< dl<>dt/dt<><true> dd>[required</em] (default>) Vérifiez si tous les nœuds sont bien formés en fonction de la version XML utilisée dans Document.xmlVersion: <ul><li> check si l’attribut Node.nodeName contient des caractères non valides en fonction de son type de nœud et génère un type, "wf-invalid-character-in-node-name"avec une DOMErrorDOMError.SEVERITY_ERROR gravité, si nécessaire ; <></li li>>< vérifie si le contenu du texte à l’intérieur Attr, , ElementComment, Text, CDATASection nœuds pour les caractères non valides et génère un DOMError type "wf-invalid-character", avec une DOMError.SEVERITY_ERROR gravité, si nécessaire ; </li li><> vérifie si les données à l’intérieur des ProcessingInstruction nœuds pour les caractères non valides et génèrent un DOMError type "wf-invalid-character", avec une DOMError.SEVERITY_ERROR gravité, si nécessaire ; </li>/ul></dd dt dt<>false dd<><>>[optional] Ne vérifiez pas la bonne forme XML.< </dd></dl></dd></dl>

La résolution des identificateurs système associés aux entités est effectuée à l’aide Document.documentURIde . Toutefois, lorsque la fonctionnalité « LS » définie dans [Chargement et enregistrement DOM niveau 3] est prise en charge par l’implémentation DOM, le paramètre « resource-resolver » peut également être utilisé sur DOMConfiguration les objets attachés aux Document nœuds. Si ce paramètre est défini, Document.normalizeDocument() appelle le programme de résolution de ressources au lieu d’utiliser Document.documentURI.

Consultez également la spécification de base du modèle objet de document (DOM) niveau 3.

Ajouté au niveau DOM 3.

Documentation Java pour org.w3c.dom.DOMConfiguration.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

Propriétés

Handle	Obtient la valeur JNI de l’objet Android sous-jacent. (Hérité de IJavaObject)
JniIdentityHashCode	Retourne la valeur de `java.lang.System.identityHashCode()` l’instance encapsulée. (Hérité de IJavaPeerable)
JniManagedPeerState	État de l’homologue managé. (Hérité de IJavaPeerable)
JniPeerMembers	Prise en charge de l’accès aux membres et de l’appel. (Hérité de IJavaPeerable)
ParameterNames	Liste des paramètres pris en charge par cet `DOMConfiguration` objet et pour lesquels au moins une valeur peut être définie par l’application.
PeerReference	Retourne une JniObjectReference instance d’objet Java encapsulée. (Hérité de IJavaPeerable)

Méthodes

CanSetParameter(String, Object)	Vérifiez si la définition d’un paramètre sur une valeur spécifique est prise en charge.
Disposed()	Appelé lorsque l’instance a été supprimée. (Hérité de IJavaPeerable)
DisposeUnlessReferenced()	S’il n’existe aucune référence en suspens à cette instance, les appels `Dispose()`; sinon, ne fait rien. (Hérité de IJavaPeerable)
Finalized()	Appelé lorsque l’instance a été finalisée. (Hérité de IJavaPeerable)
GetParameter(String)	Retourne la valeur d’un paramètre s’il est connu.
SetJniIdentityHashCode(Int32)	Définissez la valeur retournée par `JniIdentityHashCode`. (Hérité de IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	L’interface `DOMConfiguration` représente la configuration d’un document et gère une table des paramètres reconnus. (Hérité de IJavaPeerable)
SetParameter(String, Object)	Définissez la valeur d’un paramètre.
SetPeerReference(JniObjectReference)	Définissez la valeur retournée par `PeerReference`. (Hérité de IJavaPeerable)
UnregisterFromRuntime()	Annulez l’inscription de cette instance afin que le runtime ne le retourne pas à partir d’appels futurs Java.Interop.JniRuntime+JniValueManager.PeekValue . (Hérité de IJavaPeerable)

Méthodes d’extension

JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	L’interface `DOMConfiguration` représente la configuration d’un document et gère une table des paramètres reconnus.
GetJniTypeName(IJavaPeerable)	L’interface `DOMConfiguration` représente la configuration d’un document et gère une table des paramètres reconnus.

S’applique à

Partager via