DocumentFragment

DocumentFragment class

DocumentFragment è un oggetto Document “leggero” o “minimo”. È molto comune voler estrarre una parte dell’albero di un documento o creare un nuovo frammento di un documento.

public class DocumentFragment : Node, IParentNode

Proprietà

NomeDescrizione
virtual Attributes { get; }Una NamedNodeMap contenente gli attributi di questo nodo (se è un elemento) o null in caso contrario.
virtual BaseURI { get; }L’URI di base assoluto di questo nodo o null se l’implementazione non è stata in grado di ottenere un URI assoluto.
ChildElementCount { get; }Restituisce il numero corrente di nodi elemento che sono figli di questo elemento. 0 se questo elemento non ha nodi figlio di nodeType 1.
ChildNodes { get; }Un NodeList che contiene tutti i figli di questo nodo. Se non ci sono figli, questa è una NodeList che non contiene nodi..
Children { get; }Restituisce gli elementi figlio dell’elemento corrente.
FirstChild { get; }Il primo figlio di questo nodo. Se non esiste un tale nodo, restituisce null.
FirstElementChild { get; }Restituisce il primo nodo dell’elemento figlio di questo elemento. null se questo elemento non ha elementi figlio.
InnerHTML { get; set; }Restituisce un frammento di HTML o XML che rappresenta il contenuto dell’elemento. Può essere impostato, per sostituire il contenuto dell’elemento con nodi analizzati dalla stringa data.
LastChild { get; }L’ultimo figlio di questo nodo. Se non esiste un tale nodo, 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 qualificato di questo nodo. Per nodi di qualsiasi tipo diverso da ELEMENT_NODE e ATTRIBUTE_NODE e nodi creati con un metodo DOM di livello 1, come Document.createElement(), questo è sempre null.
virtual NamespaceURI { get; }L’URI dello spazio dei nomi di questo nodo o null se non è specificato.
NextElementSibling { get; }Restituisce il nodo dell’elemento di pari livello successivo 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 un tale nodo, restituisce null.
override NodeName { get; }Il nome di questo nodo, a seconda del 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 tipo.
OuterHTML { get; set; }Restituisce un frammento di HTML o XML che rappresenta l’elemento e il suo contenuto. Può essere impostato, per sostituire l’elemento con i nodi analizzati dalla stringa data.
virtual OwnerDocument { get; }L’oggetto Document associato a questo nodo. Questo è anche l’oggetto Document utilizzato per creare nuovi nodi. Quando questo nodo è un Document o un DocumentType che non è ancora utilizzato con alcun Document, questo è null.
ParentElement { get; }Ottiene il genitoreElement di questo nodo.
ParentNode { get; }Il genitore di questo nodo. Tutti i nodi, ad eccezione di Attr, Document, DocumentFragment, Entity e Notation, possono avere un padre. Tuttavia, se un nodo è stato appena creato e non è ancora stato 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 come null, l’impostazione non ha effetto
PreviousElementSibling { get; }Restituisce il nodo dell’elemento di pari livello precedente 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 un tale nodo, restituisce null.
override TextContent { get; set; }Questo attributo restituisce il contenuto di testo di questo nodo e dei suoi discendenti. Quando è definito null, l’impostazione non ha alcun effetto. Al momento dell’impostazione, tutti i possibili figli di questo nodo vengono rimossi e, se la nuova stringa non è vuota o nulla, viene sostituita da un singolo nodo di testo contenente la stringa su cui è impostato questo attributo.

Metodi

NomeDescrizione
AddEventListener(string, IEventListener)Questo metodo consente la registrazione di listener di eventi sulla destinazione dell’evento.
AddEventListener(string, DOMEventHandler, bool)Questo metodo consente la registrazione di listener di eventi sulla destinazione dell’evento.
AddEventListener(string, IEventListener, bool)Questo metodo consente la registrazione di listener di eventi sulla destinazione dell’evento.
AppendChild(Node)Aggiunge il nodo newChild alla fine dell’elenco dei figli di questo nodo. Se il nuovoChild è già nell’albero, viene prima rimosso.
CloneNode()Restituisce un duplicato di questo nodo, cioè funge da costruttore di copia generico per i nodi. Il nodo duplicato non ha padre (parentNode è null) e nessun dato utente.
CloneNode(bool)Restituisce un duplicato di questo nodo, cioè funge da costruttore di copia generico per i nodi. Il nodo duplicato non ha padre (parentNode è null) e nessun dato utente.
DispatchEvent(Event)Questo metodo consente l’invio di eventi nel modello di eventi di implementazione.
Dispose()Esegue attività definite dall’applicazione associate alla liberazione, al rilascio o al ripristino di risorse non gestite.
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.
InsertBefore(Node, Node)Inserisce il nodo prima del nodo figlio esistente. Se child è null, inserisci il nodo alla fine dell’elenco dei figli. Se child è un oggetto DocumentFragment, tutti i suoi figli vengono inseriti, nello stesso ordine, prima di child. Se il bambino è già nell’albero, viene prima rimosso.
IsDefaultNamespace(string)Questo metodo controlla 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’identità (cioè, se i due nodi sono riferimenti allo stesso oggetto) che può essere verificata con Node.isSameNode(). Anche tutti i nodi uguali saranno uguali, anche se potrebbe non essere vero il contrario.
IsSameNode(Node)Restituisce se questo nodo è lo stesso nodo di quello dato. Questo metodo fornisce un modo per determinare se due riferimenti al nodo 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, partendo da questo nodo.
LookupPrefix(string)Cerca il prefisso associato all’URI dello spazio dei nomi specificato, partendo da questo nodo. Le dichiarazioni dello spazio dei nomi predefinito vengono ignorate da questo metodo. Vedere Ricerca prefisso spazio dei nomi per i dettagli sull’algoritmo utilizzato da questo metodo.
Normalize()Inserisce 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 a 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 visualizzazione DOM di un documento sia la stessa di se fosse stato salvato e ricaricato ed è utile quando le operazioni (come le ricerche di XPointer [XPointer]) che dipendono da una particolare struttura ad albero del documento devono essere utilizzato. Se il parametro “normalize-characters” dell’oggetto DOMConfiguration allegato a Node.ownerDocument è true, questo metodo normalizzerà completamente anche i caratteri dei nodi Text.
QuerySelector(string)Restituisce il primo elemento nel documento, che corrisponde al selettore
QuerySelectorAll(string)Restituisce una NodeList di tutti gli elementi nel documento, che corrispondono a selector
RemoveChild(Node)Rimuove il nodo figlio indicato da oldChild dall’elenco dei figli e lo restituisce.
RemoveEventListener(string, IEventListener)Questo metodo consente la rimozione di 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 di 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 di 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.
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 nuovoChild è già nell’albero, viene prima rimosso.
override ToString()Restituisce aString che rappresenta questa istanza.

Guarda anche