Class Document

Document class

Il documento rappresenta l’intero documento HTML, XML o SVG. Concettualmente, è la radice dell’albero del documento e fornisce l’accesso principale ai dati del documento.

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

Proprietà

NomeDescrizione
virtual Attributes { get; }Una NamedNodeMap contenente gli attributi di questo nodo (se è un elemento) o null in caso contrario.
override BaseURI { get; }L’URI di base assoluto di questo nodo o null se l’implementazione non è stata in grado di ottenere un URI assoluto.
CharacterSet { get; }Ottiene la codifica del documento.
Charset { get; }Ottiene la codifica del documento.
ChildElementCount { get; }Restituisce il numero corrente di nodi elemento che sono figli di questo elemento. 0 se questo elemento non ha nodi figli di nodeType 1.
ChildNodes { get; }Un NodeList che contiene tutti i figli di questo nodo. Se non ci sono figli, questo è un NodeList che non contiene nodi..
Children { get; }Restituisce gli elementi figli.
ContentType { get; }Ottiene il tipo di contenuto del documento.
Context { get; }Ottiene il contesto di navigazione corrente.
DefaultView { get; }L’attributo defaultView IDL dell’interfaccia del documento, quando viene ottenuto, deve restituire l’oggetto WindowProxy del contesto di esplorazione di questo documento, se questo documento ha un contesto di esplorazione associato o null in caso contrario.
Doctype { get; }La dichiarazione del tipo di documento associata a questo documento.
DocumentElement { get; }Questo è un attributo di convenienza che consente l’accesso diretto al nodo figlio che è l’elemento documento del documento.
DocumentURI { get; }La posizione del documento o null se non definito o se il documento è stato creato utilizzando DOMImplementation.createDocument.
FirstChild { get; }Il primo figlio di questo nodo. Se non esiste tale nodo, questo restituisce null.
FirstElementChild { get; }Restituisce il primo nodo dell’elemento figlio di questo elemento. null se questo elemento non ha elementi figlio.
Implementation { get; }L’oggetto DOMImplementation che gestisce questo documento.
InputEncoding { get; }Ottiene la codifica del documento.
LastChild { get; }L’ultimo figlio di questo nodo. Se non esiste tale nodo, questo restituisce null.
LastElementChild { get; }Restituisce l’ultimo nodo dell’elemento figlio di questo elemento. null se questo elemento non ha elementi figlio.
virtual LocalName { get; }Restituisce la parte locale del nome completo di questo nodo. Per i nodi di qualsiasi tipo diverso da ELEMENT_NODE e ATTRIBUTE_NODE e per i nodi creati con un metodo DOM di livello 1, come Document.createElement(), è sempre null.
Location { get; }La posizione del documento.
virtual NamespaceURI { get; }L’URI dello spazio dei nomi di questo nodo o null se non è specificato.
NextElementSibling { get; }Restituisce il successivo nodo dell’elemento di pari livello di questo elemento. null se questo elemento non ha nodi di pari livello che vengono dopo questo nell’albero del documento.
NextSibling { get; }Il nodo immediatamente successivo a questo nodo. Se non esiste tale nodo, questo restituisce null.
override NodeName { get; }Il nome di questo nodo, a seconda del suo tipo.
override NodeType { get; }Un codice che rappresenta il tipo dell’oggetto sottostante.
virtual NodeValue { get; set; }Il valore di questo nodo, a seconda del suo tipo.
Origin { get; }Ottiene l’origine del documento.
override OwnerDocument { get; }Ottiene il documento proprietario.
ParentElement { get; }Ottiene il genitoreElement di questo nodo.
ParentNode { get; }Il padre di questo nodo. Tutti i nodi, eccetto Attr, Document, DocumentFragment, Entity e Notation possono avere un genitore. Tuttavia, se un nodo è stato appena creato e non ancora aggiunto all’albero, o se è stato rimosso dall’albero, questo è nullo.
virtual Prefix { get; set; }Il prefisso dello spazio dei nomi di questo nodo o null se non è specificato. Quando è definito nullo, impostarlo non ha effetto
PreviousElementSibling { get; }Restituisce il precedente nodo dell’elemento di pari livello di questo elemento. null se questo elemento non ha nodi di pari livello che precedono questo nell’albero del documento.
PreviousSibling { get; }Il nodo immediatamente precedente a questo nodo. Se non esiste tale nodo, questo restituisce null.
ReadyState { get; }Restituisce la disponibilità del documento. Il “caricamento” durante il caricamento del documento, “interattivo” una volta terminata l’analisi ma ancora il caricamento delle risorse secondarie e “completo” una volta caricato.
StrictErrorChecking { get; set; }Un attributo che specifica se il controllo degli errori è applicato o meno. Quando è impostata su false, l’implementazione è libera di non testare ogni possibile caso di errore normalmente definito sulle operazioni DOM e di non generare alcuna DOMException sulle operazioni DOM o di segnalare errori durante l’utilizzo di Document.normalizeDocument(). In caso di errore, il comportamento è indefinito. Questo attributo è true per impostazione predefinita.
StyleSheets { get; }Un elenco contenente tutti i fogli di stile esplicitamente collegati o incorporati in un documento. Per i documenti HTML, questo include i fogli di stile esterni, inclusi tramite l’elemento HTML LINK, e gli elementi STYLE incorporati.
virtual TextContent { get; set; }Questo attributo restituisce il contenuto testuale di questo nodo e dei suoi discendenti. Quando è definito nullo, impostarlo non ha alcun effetto. Al momento dell’impostazione, tutti i possibili figli che questo nodo può avere vengono rimossi e, se la nuova stringa non è vuota o nulla, sostituita da un singolo nodo di testo contenente la stringa su cui è impostato questo attributo.
XmlStandalone { get; set; }Un attributo che specifica, come parte della dichiarazione XML, se questo documento è autonomo. Questo è falso quando non specificato.
XmlVersion { get; set; }Un attributo che specifica, come parte della dichiarazione XML, il numero di versione di questo documento. Se non c’è alcuna dichiarazione e se questo documento supporta la funzione “XML”, il valore è “1.0”. Se questo documento non supporta la funzionalità “XML”, il valore è sempre null.

Metodi

NomeDescrizione
AddEventListener(string, IEventListener)Questo metodo consente la registrazione dei listener di eventi sul target dell’evento.
AddEventListener(string, DOMEventHandler, bool)Questo metodo consente la registrazione dei listener di eventi sul target dell’evento.
AddEventListener(string, IEventListener, bool)Questo metodo consente la registrazione dei listener di eventi sul target dell’evento.
AppendChild(Node)Aggiunge il nodo newChild alla fine dell’elenco dei figli di questo nodo. Se il newChild è già nell’albero, viene prima rimosso.
CloneNode()Restituisce un duplicato di questo nodo, ovvero funge da costruttore di copie generico per i nodi. Il nodo duplicato non ha un genitore (parentNode è nullo) e nessun dato utente.
CloneNode(bool)Restituisce un duplicato di questo nodo, ovvero funge da costruttore di copie generico per i nodi. Il nodo duplicato non ha un genitore (parentNode è nullo) e nessun dato utente.
CreateAttribute(string)Crea un Attr con il nome dato.
CreateAttributeNS(string, string)Crea un attributo del nome completo e dell’URI dello spazio dei nomi forniti.
CreateCDATASection(string)Crea un nodo CDATASection il cui valore è la stringa specificata.
CreateComment(string)Crea un nodo Comment data la stringa specificata.
CreateDocumentFragment()Crea un oggetto DocumentFragment vuoto.
CreateDocumentType(string, string, string, string)Crea un nodo DocumentType.
CreateElement(string)Crea un elemento del tipo specificato. Si noti che l’istanza restituita implementa l’interfaccia Element, quindi gli attributi possono essere specificati direttamente sull’oggetto restituito.
CreateElementNS(string, string)Crea un elemento del nome completo e dell’URI dello spazio dei nomi forniti.
CreateEntityReference(string)Crea un oggetto EntityReference. Inoltre, se l’entità referenziata è nota, l’elenco figlio del nodo EntityReference viene reso uguale a quello del nodo Entity corrispondente.
CreateEvent(string)Crea un fileEvent di un tipo supportato dall’implementazione.
CreateExpression(string, IXPathNSResolver)Crea un’espressione XPath analizzata con spazi dei nomi risolti. Questo è utile quando un’espressione verrà riutilizzata in un’applicazione poiché rende possibile compilare la stringa dell’espressione in un formato interno più efficiente e pre-risolvere tutti i prefissi dello spazio dei nomi che ricorrono all’interno dell’espressione.
CreateNodeIterator(Node)Crea un nuovo NodeIterator sulla sottostruttura radicata nel nodo specificato.
CreateNodeIterator(Node, long)Crea un nuovo NodeIterator sulla sottostruttura radicata nel nodo specificato.
CreateNodeIterator(Node, long, INodeFilter)Crea un nuovo NodeIterator sulla sottostruttura radicata nel nodo specificato.
CreateNSResolver(Node)Adatta qualsiasi nodo DOM per risolvere gli spazi dei nomi in modo che un’espressione XPath possa essere facilmente valutata rispetto al contesto del nodo in cui è apparsa all’interno del documento. Questo adattatore funziona come il metodo DOM Level 3lookupNamespaceURI sui nodi nel risolvere il namespaceURI da un dato prefisso utilizzando le informazioni correnti disponibili nella gerarchia del nodo al momento viene chiamato lookupNamespaceURI, risolvendo anche correttamente il prefisso xml implicito.
CreateProcessingInstruction(string, string)Crea un nodo ProcessingInstruction con il nome e le stringhe di dati specificati.
CreateTextNode(string)Crea un nodo di testo data la stringa specificata.
CreateTreeWalker(Node)Crea un nuovo TreeWalker sul sottoalbero radicato nel nodo specificato.
CreateTreeWalker(Node, long)Crea un nuovo TreeWalker sul sottoalbero radicato nel nodo specificato.
CreateTreeWalker(Node, long, INodeFilter)Crea un nuovo TreeWalker sul sottoalbero radicato nel nodo specificato.
DispatchEvent(Event)Questo metodo consente l’invio di eventi nel modello di eventi delle implementazioni.
Dispose()Esegue attività definite dall’applicazione associate alla liberazione, al rilascio o al ripristino di risorse non gestite.
Evaluate(string, Node, IXPathNSResolver, XPathResultType, object)Valuta una stringa di espressione XPath e, se possibile, restituisce un risultato del tipo specificato.
GetElementById(string)Restituisce l’elemento che ha un attributo ID con il valore specificato. Se tale elemento non esiste, questo restituisce null. Se più di un elemento ha un attributo ID con quel valore, ciò che viene restituito è indefinito.
GetElementsByClassName(string)Restituisce un oggetto NodeList attivo contenente tutti gli elementi nel documento che hanno tutte le classi specificate nell’argomento. http://www.w3.org/TR/dom/
GetElementsByTagName(string)Restituisce una NodeList di tutti gli elementi in ordine di documento con un dato nome di tag e sono contenuti nel documento.
GetElementsByTagNameNS(string, string)Restituisce un NodeList di tutti gli elementi con un dato nome locale e URI dello spazio dei nomi nell’ordine del documento.
virtual GetPlatformType()Questo metodo viene utilizzato per recuperare l’oggetto ECMAScriptType .
virtual HasAttributes()Restituisce se questo nodo (se è un elemento) ha attributi
HasChildNodes()Restituisce se questo nodo ha figli.
ImportNode(Node, bool)Importa un nodo da un altro documento in questo documento, senza alterare o rimuovere il nodo sorgente dal documento originale; questo metodo crea una nuova copia del nodo sorgente.
InsertBefore(Node, Node)Inserisce il nodo prima del nodo figlio esistente figlio. Se child è null, inserisci il nodo alla fine dell’elenco dei child. Se child è un oggetto DocumentFragment, tutti i suoi child vengono inseriti, nello stesso ordine, prima di child. Se il figlio è già nell’albero, viene prima rimosso.
IsDefaultNamespace(string)Questo metodo verifica se il namespaceURI specificato è lo spazio dei nomi predefinito o meno.
IsEqualNode(Node)Verifica se due nodi sono uguali. Questo metodo verifica l’uguaglianza dei nodi, non l’uguaglianza (ovvero, se i due nodi sono riferimenti allo stesso oggetto) che possono essere verificati con Node.isSameNode(). Anche tutti i nodi uguali saranno uguali, anche se il contrario potrebbe non essere vero.
IsSameNode(Node)Restituisce se questo nodo è lo stesso nodo di quello dato. Questo metodo fornisce un modo per determinare se due riferimenti Node restituiti dall’implementazione fanno riferimento allo stesso oggetto. Quando due riferimenti Node sono riferimenti allo stesso oggetto, anche se tramite un proxy, i riferimenti possono essere utilizzati in modo completamente intercambiabile, in modo tale che tutti gli attributi abbiano gli stessi valori e chiamare lo stesso metodo DOM su entrambi i riferimenti ha sempre esattamente lo stesso effetto.
LookupNamespaceURI(string)Cerca l’URI dello spazio dei nomi associato al prefisso dato, a partire da questo nodo.
LookupPrefix(string)Cerca il prefisso associato all’URI del namespace dato, a partire da questo nodo. Le dichiarazioni predefinite dello spazio dei nomi vengono ignorate da questo metodo. Vedere Ricerca prefisso nello spazio dei nomi per i dettagli sull’algoritmo utilizzato da questo metodo.
Navigate(RequestMessage)Carica il documento in base all’oggetto di richiesta specificato, sostituendo il contenuto precedente.
Navigate(string)Carica il documento all’URL (Uniform Resource Locator) specificato nell’istanza corrente, sostituendo il contenuto precedente.
Navigate(Url)Carica il documento all’URL (Uniform Resource Locator) specificato nell’istanza corrente, sostituendo il contenuto precedente.
Navigate(Stream, string)Carica il documento dal contenuto specificato e utilizza baseUri per risolvere le risorse relative, sostituendo il contenuto precedente. Il caricamento del documento inizia dalla posizione corrente nello stream.
Navigate(Stream, Url)Carica il documento dal contenuto specificato e utilizza baseUri per risolvere le risorse relative, sostituendo il contenuto precedente. Il caricamento del documento inizia dalla posizione corrente nello stream.
Navigate(string, string)Carica il documento dal contenuto specificato e utilizza baseUri per risolvere le relative risorse, sostituendo il contenuto precedente.
Navigate(string, Url)Carica il documento dal contenuto specificato e utilizza baseUri per risolvere le relative risorse, sostituendo il contenuto precedente.
Normalize()Mette tutti i nodi di testo nell’intera profondità del sottoalbero sotto questo nodo, inclusi i nodi di attributo, in una forma “normale” in cui solo la struttura (ad es. elementi, commenti, istruzioni di elaborazione, sezioni CDATA e riferimenti di entità) separa il testo nodi, cioè non ci sono né nodi di testo adiacenti né nodi di testo vuoti. Questo può essere utilizzato per garantire che la vista DOM di un documento sia la stessa di se fosse stato salvato e ricaricato, ed è utile quando le operazioni (come le ricerche XPointer [XPointer]) che dipendono da una particolare struttura ad albero del documento devono essere usato. Se il parametro “normalize-characters” dell’oggetto DOMConfiguration allegato al Node.ownerDocument è vero, questo metodo normalizzerà completamente anche i caratteri dei nodi Text.
QuerySelector(string)Restituisce il primo elemento nel documento, che corrisponde a selector
QuerySelectorAll(string)Restituisce un NodeList di tutti gli elementi nel documento, che corrispondono a selector
RemoveChild(Node)Rimuove il nodo figlio indicato da oldChild dalla lista dei figli, e lo restituisce.
RemoveEventListener(string, IEventListener)Questo metodo consente la rimozione dei listener di eventi dalla destinazione dell’evento. Se unIEventListener viene rimosso da unEventTarget mentre sta elaborando un evento, non verrà attivato dalle azioni correnti. I listener di eventi non possono mai essere richiamati dopo essere stati rimossi.
RemoveEventListener(string, DOMEventHandler, bool)Questo metodo consente la rimozione dei listener di eventi dalla destinazione dell’evento. Se unIEventListener viene rimosso da unEventTarget mentre sta elaborando un evento, non verrà attivato dalle azioni correnti. I listener di eventi non possono mai essere richiamati dopo essere stati rimossi.
RemoveEventListener(string, IEventListener, bool)Questo metodo consente la rimozione dei listener di eventi dalla destinazione dell’evento. Se unIEventListener viene rimosso da unEventTarget mentre sta elaborando un evento, non verrà attivato dalle azioni correnti. I listener di eventi non possono mai essere richiamati dopo essere stati rimossi.
virtual RenderTo(IDevice)Questo metodo viene utilizzato per eseguire il rendering del contenuto del documento corrente su un dispositivo grafico specificato.
ReplaceChild(Node, Node)Sostituisce il nodo figlio oldChild con newChild nell’elenco dei figli e restituisce il nodo oldChild. Se newChild è un oggetto DocumentFragment, oldChild viene sostituito da tutti i figli DocumentFragment, che vengono inseriti nello stesso ordine. Se il newChild è già nell’albero, viene prima rimosso.
override ToString()Restituisce aString che rappresenta questa istanza.
Write(params string[])Scrive una stringa di testo in un flusso di documenti aperto da open(). Si noti che la funzione produrrà un documento che non è necessariamente guidato da un DTD e pertanto potrebbe produrre un risultato non valido nel contesto del documento.
WriteLn(params string[])Scrive una stringa di testo seguita da un carattere di nuova riga in un flusso document aperto da open(). Si noti che la funzione produrrà un documento che non è necessariamente guidato da un DTD e pertanto potrebbe produrre un risultato non valido nel contesto del document

Eventi

NomeDescrizione
event OnAbortOttiene o imposta il gestore eventi per l’evento OnAbort.
event OnBlurOttiene o imposta il gestore eventi per l’evento OnBlur.
event OnCancelOttiene o imposta il gestore eventi per l’evento OnCancel.
event OnCanplayOttiene o imposta il gestore eventi per l’evento OnCanplay.
event OnCanPlayThroughOttiene o imposta il gestore eventi per l’evento OnCanPlayThrough.
event OnChangeOttiene o imposta il gestore eventi per l’evento OnChange.
event OnClickOttiene o imposta il gestore eventi per l’evento OnClick.
event OnCueChangeOttiene o imposta il gestore eventi per l’evento OnCueChange.
event OnDblClickOttiene o imposta il gestore eventi per l’evento OnDblClick.
event OnDurationChangeOttiene o imposta il gestore eventi per l’evento OnDurationChange.
event OnEmptiedOttiene o imposta il gestore eventi per l’evento OnEmptied.
event OnEndedOttiene o imposta il gestore eventi per l’evento OnEnded.
event OnErrorOttiene o imposta il gestore eventi per l’evento OnError.
event OnFocusOttiene o imposta il gestore eventi per l’evento OnFocus.
event OnInputOttiene o imposta il gestore eventi per l’evento OnInput.
event OnInvalidOttiene o imposta il gestore eventi per l’evento OnInvalid.
event OnKeyDownOttiene o imposta il gestore eventi per l’evento OnKeyDown.
event OnKeyPressOttiene o imposta il gestore eventi per l’evento OnKeyPress.
event OnKeyUpOttiene o imposta il gestore eventi per l’evento OnKeyUp.
event OnLoadOttiene o imposta il gestore eventi per l’evento OnLoad.
event OnLoadedDataOttiene o imposta il gestore eventi per l’evento OnLoadedData.
event OnLoadedMetadataOttiene o imposta il gestore eventi per l’evento OnLoadedMetadata.
event OnLoadStartOttiene o imposta il gestore eventi per l’evento OnLoadStart.
event OnMouseDownOttiene o imposta il gestore eventi per l’evento OnMouseDown.
event OnMouseEnterOttiene o imposta il gestore eventi per l’evento OnMouseEnter.
event OnMouseLeaveOttiene o imposta il gestore eventi per l’evento OnMouseLeave.
event OnMouseMoveOttiene o imposta il gestore eventi per l’evento OnMouseMove.
event OnMouseOutOttiene o imposta il gestore eventi per l’evento OnMouseOut.
event OnMouseOverOttiene o imposta il gestore eventi per l’evento OnMouseOver.
event OnMouseUpOttiene o imposta il gestore eventi per l’evento OnMouseUp.
event OnMouseWheelOttiene o imposta il gestore eventi per l’evento OnMouseWheel.
event OnPauseOttiene o imposta il gestore eventi per l’evento OnPause.
event OnPlayOttiene o imposta il gestore eventi per l’evento OnPlay.
event OnPlayingOttiene o imposta il gestore eventi per l’evento OnPlaying.
event OnProgressOttiene o imposta il gestore eventi per l’evento OnProgress.
event OnRateChangeOttiene o imposta il gestore eventi per l’evento OnRateChange.
event OnReadyStateChangeOttiene o imposta il gestore eventi per l’evento OnReadyStateChange.
event OnResetOttiene o imposta il gestore eventi per l’evento OnReset.
event OnResizeOttiene o imposta il gestore eventi per l’evento OnResize.
event OnScrollOttiene o imposta il gestore eventi per l’evento OnScroll.
event OnSeekedOttiene o imposta il gestore eventi per l’evento OnSeeked.
event OnSeekingOttiene o imposta il gestore eventi per l’evento OnSeeking.
event OnSelectOttiene o imposta il gestore eventi per l’evento OnSelect.
event OnShowOttiene o imposta il gestore eventi per l’evento OnShow.
event OnStalledOttiene o imposta il gestore eventi per l’evento OnStalled.
event OnSubmitOttiene o imposta il gestore eventi per l’evento OnSubmit.
event OnSuspendOttiene o imposta il gestore eventi per l’evento OnSuspend.
event OnTimeUpdateOttiene o imposta il gestore eventi per l’evento OnTimeUpdate.
event OnToggleOttiene o imposta il gestore eventi per l’evento OnToggle.
event OnVolumeChangeOttiene o imposta il gestore eventi per l’evento OnVolumeChange.
event OnWaitingOttiene o imposta il gestore eventi per l’evento OnWaiting.

Guarda anche