Document

Document class

Le Document représente l’intégralité du document HTML, XML ou SVG. Conceptuellement, il s’agit de la racine de l’arborescence du document et fournit l’accès principal aux données du document.

public class Document : Node, IDocumentEvent, IDocumentStyle, IDocumentTraversal, 
    IGlobalEventHandlers, INonElementParentNode, IParentNode, IXPathEvaluator

Propriétés

NomLa description
virtual Attributes { get; }Un NamedNodeMap contenant les attributs de ce nœud (si c’est un Element) ou null sinon.
override BaseURI { get; }L’URI de base absolu de ce nœud ou null si l’implémentation n’a pas pu obtenir d’URI absolu.
CharacterSet { get; }Récupère l’encodage du document.
Charset { get; }Récupère l’encodage du document.
ChildElementCount { get; }Renvoie le nombre actuel de nœuds d’élément qui sont des enfants de cet élément. 0 si cet élément n’a pas de nœuds enfants qui sont de nodeType 1.
ChildNodes { get; }Une NodeList qui contient tous les enfants de ce nœud. S’il n’y a pas d’enfants, il s’agit d’une NodeList ne contenant aucun nœud..
Children { get; }Renvoie les éléments enfants.
ContentType { get; }Obtient le type de contenu du document.
Context { get; }Obtient le contexte de navigation actuel.
DefaultView { get; }L’attribut defaultView IDL de l’interface Document, lors de l’obtention, doit renvoyer l’objet WindowProxy du contexte de navigation de ce document, si ce document a un contexte de navigation associé, ou null sinon.
Doctype { get; }La déclaration de type de document associée à ce document.
DocumentElement { get; }Il s’agit d’un attribut de commodité qui permet un accès direct au nœud enfant qui est l’élément de document du document.
DocumentURI { get; }L’emplacement du document ou null si non défini ou si le document a été créé à l’aide de DOMImplementation.createDocument.
FirstChild { get; }Le premier enfant de ce nœud. S’il n’y a pas de tel nœud, cela renvoie null.
FirstElementChild { get; }Renvoie le premier nœud d’élément enfant de cet élément. null si cet élément n’a pas d’éléments enfants.
Implementation { get; }L’objet DOMImplementation qui gère ce document.
InputEncoding { get; }Récupère l’encodage du document.
LastChild { get; }Le dernier enfant de ce nœud. S’il n’y a pas de tel nœud, cela renvoie null.
LastElementChild { get; }Renvoie le dernier nœud d’élément enfant de cet élément. null si cet élément n’a pas d’éléments enfants.
virtual LocalName { get; }Renvoie la partie locale du nom qualifié de ce nœud. Pour les nœuds de tout type autre que ELEMENT_NODE et ATTRIBUTE_NODE et les nœuds créés avec une méthode DOM Niveau 1, comme Document.createElement(), c’est toujours null.
Location { get; }L’emplacement du document.
virtual NamespaceURI { get; }L’URI de l’espace de noms de ce nœud, ou null s’il n’est pas spécifié.
NextElementSibling { get; }Renvoie le prochain nœud d’élément frère de cet élément. null si cet élément n’a aucun nœud frère d’élément qui vient après celui-ci dans l’arborescence du document.
NextSibling { get; }Le nœud suivant immédiatement ce nœud. S’il n’y a pas de tel nœud, cela renvoie null.
override NodeName { get; }Le nom de ce nœud, en fonction de son type.
override NodeType { get; }Un code représentant le type de l’objet sous-jacent.
virtual NodeValue { get; set; }La valeur de ce nœud, en fonction de son type.
Origin { get; }Obtient l’origine du document.
override OwnerDocument { get; }Obtient le document propriétaire.
ParentElement { get; }Obtient le parentElement de ce nœud.
ParentNode { get; }Le parent de ce nœud. Tous les nœuds, à l’exception de Attr, Document, DocumentFragment, Entity et Notation peuvent avoir un parent. Cependant, si un nœud vient d’être créé et n’a pas encore été ajouté à l’arbre, ou s’il a été supprimé de l’arbre, c’est null.
virtual Prefix { get; set; }Le préfixe d’espace de noms de ce nœud, ou null s’il n’est pas spécifié. Lorsqu’il est défini comme étant nul, sa définition n’a aucun effet
PreviousElementSibling { get; }Renvoie le nœud d’élément frère précédent de cet élément. null si cet élément n’a aucun nœud frère d’élément qui précède celui-ci dans l’arborescence du document.
PreviousSibling { get; }Le nœud précédant immédiatement ce nœud. S’il n’y a pas de tel nœud, cela renvoie null.
ReadyState { get; }Renvoie l’état de préparation du document. Le « chargement » pendant le chargement du document, « interactif » une fois qu’il a terminé l’analyse mais charge toujours les sous-ressources, et « complet » une fois qu’il a été chargé.
StrictErrorChecking { get; set; }Un attribut spécifiant si la vérification des erreurs est appliquée ou non. Lorsqu’il est défini sur false, l’implémentation est libre de ne pas tester tous les cas d’erreur possibles normalement définis sur les opérations DOM, et de ne pas déclencher d’exception DOMException sur les opérations DOM ou de signaler des erreurs lors de l’utilisation de Document.normalizeDocument(). En cas d’erreur, le comportement est indéfini. Cet attribut est vrai par défaut.
StyleSheets { get; }Une liste contenant toutes les feuilles de style explicitement liées ou incorporées dans un document. Pour les documents HTML, cela inclut les feuilles de style externes, incluses via l’élément HTML LINK, et les éléments STYLE en ligne.
virtual TextContent { get; set; }Cet attribut renvoie le contenu textuel de ce nœud et de ses descendants. Lorsqu’il est défini comme étant nul, sa définition n’a aucun effet. Lors de la définition, tous les enfants possibles que ce nœud peut avoir sont supprimés et, si la nouvelle chaîne n’est pas vide ou nulle, remplacés par un seul nœud de texte contenant la chaîne à laquelle cet attribut est défini.
XmlStandalone { get; set; }Un attribut spécifiant, dans le cadre de la déclaration XML, si ce document est autonome. Ceci est faux lorsqu’il n’est pas spécifié.
XmlVersion { get; set; }Un attribut spécifiant, dans le cadre de la déclaration XML, le numéro de version de ce document. S’il n’y a pas de déclaration et si ce document prend en charge la fonctionnalité “XML”, la valeur est “1.0”. Si ce document ne prend pas en charge la fonctionnalité “XML”, la valeur est toujours nulle.

Méthodes

NomLa description
AddEventListener(string, IEventListener)Cette méthode permet l’enregistrement des écouteurs d’événement sur la cible de l’événement.
AddEventListener(string, DOMEventHandler, bool)Cette méthode permet l’enregistrement des écouteurs d’événement sur la cible de l’événement.
AddEventListener(string, IEventListener, bool)Cette méthode permet l’enregistrement des écouteurs d’événement sur la cible de l’événement.
AppendChild(Node)Ajoute le nœud newChild à la fin de la liste des enfants de ce nœud. Si le newChild est déjà dans l’arborescence, il est d’abord supprimé.
CloneNode()Renvoie un doublon de ce nœud, c’est-à-dire qu’il sert de constructeur de copie générique pour les nœuds. Le nœud dupliqué n’a pas de parent (parentNode est nul) et pas de données utilisateur.
CloneNode(bool)Renvoie un doublon de ce nœud, c’est-à-dire qu’il sert de constructeur de copie générique pour les nœuds. Le nœud dupliqué n’a pas de parent (parentNode est nul) et pas de données utilisateur.
CreateAttribute(string)Crée un Attr du nom donné.
CreateAttributeNS(string, string)Crée un attribut du nom qualifié donné et de l’URI de l’espace de noms.
CreateCDATASection(string)Crée un nœud CDATASection dont la valeur est la chaîne spécifiée.
CreateComment(string)Crée un nœud Commentaire en fonction de la chaîne spécifiée.
CreateDocumentFragment()Crée un objet DocumentFragment vide.
CreateDocumentType(string, string, string, string)Crée un nœud DocumentType.
CreateElement(string)Crée un élément du type spécifié. Notez que l’instance renvoyée implémente l’interface Element, de sorte que les attributs peuvent être spécifiés directement sur l’objet renvoyé.
CreateElementNS(string, string)Crée un élément du nom qualifié donné et de l’URI de l’espace de noms.
CreateEntityReference(string)Crée un objet EntityReference. De plus, si l’entité référencée est connue, la liste enfant du nœud EntityReference est identique à celle du nœud Entity correspondant.
CreateEvent(string)Crée unEvent d’un type pris en charge par l’implémentation.
CreateExpression(string, IXPathNSResolver)Crée une expression XPath analysée avec des espaces de noms résolus. Ceci est utile lorsqu’une expression sera réutilisée dans une application car cela permet de compiler la chaîne d’expression dans une forme interne plus efficace et de pré-résoudre tous les préfixes d’espace de noms qui se produisent dans l’expression.
CreateNodeIterator(Node)Créer un nouveau NodeIterator sur la sous-arborescence enracinée au nœud spécifié.
CreateNodeIterator(Node, long)Créer un nouveau NodeIterator sur la sous-arborescence enracinée au nœud spécifié.
CreateNodeIterator(Node, long, INodeFilter)Créer un nouveau NodeIterator sur la sous-arborescence enracinée au nœud spécifié.
CreateNSResolver(Node)Adapte n’importe quel nœud DOM pour résoudre les espaces de noms afin qu’une expression XPath puisse être facilement évaluée par rapport au contexte du nœud où elle est apparue dans le document. Cet adaptateur fonctionne comme la méthode DOM niveau 3lookupNamespaceURI sur les nœuds en résolvant le namespaceURI à partir d’un préfixe donné en utilisant les informations actuelles disponibles dans la hiérarchie du nœud au moment où lookupNamespaceURI est appelé, en résolvant également correctement le préfixe xml implicite.
CreateProcessingInstruction(string, string)Crée un nœud ProcessingInstruction avec le nom et les chaînes de données spécifiés.
CreateTextNode(string)Crée un nœud de texte en fonction de la chaîne spécifiée.
CreateTreeWalker(Node)Créer un nouveau TreeWalker sur le sous-arbre enraciné au nœud spécifié.
CreateTreeWalker(Node, long)Créer un nouveau TreeWalker sur le sous-arbre enraciné au nœud spécifié.
CreateTreeWalker(Node, long, INodeFilter)Créer un nouveau TreeWalker sur le sous-arbre enraciné au nœud spécifié.
DispatchEvent(Event)Cette méthode permet de répartir les événements dans le modèle d’événement des implémentations.
Dispose()Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non gérées.
Evaluate(string, Node, IXPathNSResolver, XPathResultType, object)Évalue une chaîne d’expression XPath et renvoie un résultat du type spécifié si possible.
GetElementById(string)Renvoie l’élément qui a un attribut ID avec la valeur donnée. Si aucun élément de ce type n’existe, cela renvoie null. Si plusieurs éléments ont un attribut ID avec cette valeur, ce qui est renvoyé est indéfini.
GetElementsByClassName(string)Renvoie un objet NodeList actif contenant tous les éléments du document qui ont toutes les classes spécifiées dans l’argument. http://www.w3.org/TR/dom/
GetElementsByTagName(string)Renvoie une NodeList de tous les éléments dans l’ordre du document avec un nom de balise donné et sont contenus dans le document.
GetElementsByTagNameNS(string, string)Renvoie une NodeList de tous les éléments avec un nom local et un URI d’espace de noms donnés dans l’ordre du document.
virtual GetPlatformType()Cette méthode est utilisée pour récupérer l’objet ECMAScriptType .
virtual HasAttributes()Renvoie si ce nœud (s’il s’agit d’un élément) a des attributs
HasChildNodes()Renvoie si ce nœud a des enfants.
ImportNode(Node, bool)Importe un nœud d’un autre document vers ce document, sans modifier ni supprimer le nœud source du document d’origine ; cette méthode crée une nouvelle copie du nœud source.
InsertBefore(Node, Node)Insère le nœud avant le nœud enfant existant. Si enfant est nul, insère le nœud à la fin de la liste des enfants. Si enfant est un objet DocumentFragment, tous ses enfants sont insérés, dans le même ordre, avant enfant. Si l’enfant est déjà dans l’arborescence, il est d’abord supprimé.
IsDefaultNamespace(string)Cette méthode vérifie si le namespaceURI spécifié est l’espace de noms par défaut ou non.
IsEqualNode(Node)Teste si deux nœuds sont égaux. Cette méthode teste l’égalité des nœuds, pas la similitude (c’est-à-dire si les deux nœuds sont des références au même objet) qui peut être testée avec Node.isSameNode(). Tous les nœuds identiques seront également égaux, bien que l’inverse puisse ne pas être vrai.
IsSameNode(Node)Renvoie si ce nœud est le même nœud que celui donné. Cette méthode permet de déterminer si deux références de nœud renvoyées par l’implémentation font référence au même objet. Lorsque deux références de nœud sont des références au même objet, même via un proxy, les références peuvent être utilisées de manière complètement interchangeable, de sorte que tous les attributs ont les mêmes valeurs et que l’appel de la même méthode DOM sur l’une ou l’autre des références a toujours exactement le même effet.
LookupNamespaceURI(string)Recherchez l’URI de l’espace de noms associé au préfixe donné, à partir de ce nœud.
LookupPrefix(string)Recherchez le préfixe associé à l’URI de l’espace de noms donné, à partir de ce nœud. Les déclarations d’espace de noms par défaut sont ignorées par cette méthode. Voir Recherche de préfixe d’espace de noms pour plus de détails sur l’algorithme utilisé par cette méthode.
Navigate(RequestMessage)Charge le document en fonction de l’objet de requête spécifié, en remplaçant le contenu précédent.
Navigate(string)Charge le document à l’URL (Uniform Resource Locator) spécifiée dans l’instance actuelle, en remplaçant le contenu précédent.
Navigate(Url)Charge le document à l’URL (Uniform Resource Locator) spécifiée dans l’instance actuelle, en remplaçant le contenu précédent.
Navigate(Stream, string)Charge le document à partir du contenu spécifié et utilise baseUri pour résoudre les ressources relatives, en remplaçant le contenu précédent. Le chargement du document commence à partir de la position actuelle dans le flux.
Navigate(Stream, Url)Charge le document à partir du contenu spécifié et utilise baseUri pour résoudre les ressources relatives, en remplaçant le contenu précédent. Le chargement du document commence à partir de la position actuelle dans le flux.
Navigate(string, string)Charge le document à partir du contenu spécifié et utilise baseUri pour résoudre les ressources relatives, en remplaçant le contenu précédent.
Navigate(string, Url)Charge le document à partir du contenu spécifié et utilise baseUri pour résoudre les ressources relatives, en remplaçant le contenu précédent.
Normalize()Met tous les nœuds de texte dans toute la profondeur de la sous-arborescence sous ce nœud, y compris les nœuds d’attribut, dans une forme “normale” où seule la structure (par exemple, les éléments, les commentaires, les instructions de traitement, les sections CDATA et les références d’entité) sépare le texte nœuds, c’est-à-dire qu’il n’y a ni nœuds Text adjacents ni nœuds Text vides. Cela peut être utilisé pour s’assurer que la vue DOM d’un document est la même que s’il avait été enregistré et rechargé, et est utile lorsque des opérations (telles que les recherches XPointer [XPointer]) qui dépendent d’une arborescence de document particulière doivent être utilisé. Si le paramètre “normalize-characters” de l’objet DOMConfiguration attaché au Node.ownerDocument est vrai, cette méthode normalisera également complètement les caractères des nœuds Text.
QuerySelector(string)Renvoie le premier élément du document, qui correspond à selector
QuerySelectorAll(string)Renvoie une NodeList de tous les éléments du document, qui correspondent à selector
RemoveChild(Node)Supprime le nœud enfant indiqué par oldChild de la liste des enfants et le renvoie.
RemoveEventListener(string, IEventListener)Cette méthode permet de supprimer les écouteurs d’événement de la cible de l’événement. Si unIEventListener est retiré d’unEventTarget pendant qu’il traite un événement, il ne sera pas déclenché par les actions en cours. Les écouteurs d’événement ne peuvent jamais être invoqués après avoir été supprimés.
RemoveEventListener(string, DOMEventHandler, bool)Cette méthode permet de supprimer les écouteurs d’événement de la cible de l’événement. Si unIEventListener est retiré d’unEventTarget pendant qu’il traite un événement, il ne sera pas déclenché par les actions en cours. Les écouteurs d’événement ne peuvent jamais être invoqués après avoir été supprimés.
RemoveEventListener(string, IEventListener, bool)Cette méthode permet de supprimer les écouteurs d’événement de la cible de l’événement. Si unIEventListener est retiré d’unEventTarget pendant qu’il traite un événement, il ne sera pas déclenché par les actions en cours. Les écouteurs d’événement ne peuvent jamais être invoqués après avoir été supprimés.
virtual RenderTo(IDevice)Cette méthode est utilisée pour afficher le contenu du document actuel sur un périphérique graphique spécifié.
ReplaceChild(Node, Node)Remplace le nœud enfant oldChild par newChild dans la liste des enfants et renvoie le nœud oldChild. Si newChild est un objet DocumentFragment, oldChild est remplacé par tous les enfants DocumentFragment, qui sont insérés dans le même ordre. Si le newChild est déjà dans l’arborescence, il est d’abord supprimé.
override ToString()Renvoie unString qui représente cette instance.
Write(params string[])Ecrit une chaîne de texte dans un flux de documents ouvert par open(). Notez que la fonction produira un document qui n’est pas nécessairement piloté par une DTD et peut donc être produire un résultat invalide dans le contexte du document.
WriteLn(params string[])Écrit une chaîne de texte suivie d’un caractère de saut de ligne dans un flux document ouvert par open(). Notez que la fonction va produire un document qui n’est pas nécessairement piloté par une DTD et peut donc produire un résultat invalide dans le contexte du document

Voir également