XDocument Classe

Definizione

Spazio dei nomi:
System.Xml.Linq
Assembly:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
System.Xml.XDocument.dll
Assembly:
netstandard.dll

Rappresenta un documento XML. Per i componenti e l'utilizzo di un XDocument oggetto, vedere Panoramica della classe XDocument.

public ref class XDocument : System::Xml::Linq::XContainer
public class XDocument : System.Xml.Linq.XContainer
type XDocument = class
    inherit XContainer
Public Class XDocument
Inherits XContainer
Ereditarietà
Object
XObject
XNode
XContainer
XDocument

Esempio

Nell'esempio seguente viene creato un documento e quindi viene aggiunto un commento e un elemento. Crea quindi un altro documento usando i risultati di una query.

XDocument srcTree = new XDocument(
    new XComment("This is a comment"),
    new XElement("Root",
        new XElement("Child1", "data1"),
        new XElement("Child2", "data2"),
        new XElement("Child3", "data3"),
        new XElement("Child2", "data4"),
        new XElement("Info5", "info5"),
        new XElement("Info6", "info6"),
        new XElement("Info7", "info7"),
        new XElement("Info8", "info8")
    )
);

XDocument doc = new XDocument(
    new XComment("This is a comment"),
    new XElement("Root",
        from el in srcTree.Element("Root").Elements()
        where ((string)el).StartsWith("data")
        select el
    )
);
Console.WriteLine(doc);

Dim srcTree As XDocument = _
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
        <!--This is a comment-->
        <Root>
            <Child1>data1</Child1>
            <Child2>data2</Child2>
            <Child3>data3</Child3>
            <Child2>data4</Child2>
            <Info5>info5</Info5>
            <Info6>info6</Info6>
            <Info7>info7</Info7>
            <Info8>info8</Info8>
        </Root>
Dim doc As XDocument = _
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
        <!--This is a comment-->
        <Root>
            <%= From el In srcTree.<Root>.Elements _
                Where CStr(el).StartsWith("data") _
                Select el %>
        </Root>
Console.WriteLine(doc)

In questo esempio viene generato l'output seguente:

<!--This is a comment-->
<Root>
  <Child1>data1</Child1>
  <Child2>data2</Child2>
  <Child3>data3</Child3>
  <Child2>data4</Child2>
</Root>

Commenti

Per informazioni dettagliate sul contenuto valido di un oggetto XDocument, vedere Contenuto valido di oggetti XElement e XDocument.

Costruttori

Nome Descrizione
XDocument()

Inizializza una nuova istanza della classe XDocument.
XDocument(Object[])

Inizializza una nuova istanza della XDocument classe con il contenuto specificato.
XDocument(XDeclaration, Object[])

Inizializza una nuova istanza della XDocument classe con il contenuto e specificato XDeclaration .
XDocument(XDocument)

Inizializza una nuova istanza della XDocument classe da un oggetto esistente XDocument .

Proprietà

Nome Descrizione
BaseUri

Ottiene l'URI di base per questo XObjectoggetto .

(Ereditato da XObject)
Declaration

Ottiene o imposta la dichiarazione XML per questo documento.
Document

Ottiene l'oggetto per l'oggetto XDocumentXObject.

(Ereditato da XObject)
DocumentType

Ottiene la definizione del tipo di documento (DTD) per questo documento.
FirstNode

Ottiene il primo nodo figlio di questo nodo.

(Ereditato da XContainer)
LastNode

Ottiene l'ultimo nodo figlio di questo nodo.

(Ereditato da XContainer)
NextNode

Ottiene il nodo di pari livello successivo di questo nodo.

(Ereditato da XNode)
NodeType

Ottiene il tipo di nodo per questo nodo.
Parent

Ottiene l'elemento padre XElement dell'oggetto XObject.

(Ereditato da XObject)
PreviousNode

Ottiene il nodo di pari livello precedente di questo nodo.

(Ereditato da XNode)
Root

Ottiene l'elemento radice dell'albero XML per questo documento.

Metodi

Nome Descrizione
Add(Object)

Aggiunge il contenuto specificato come elementi figlio di questo XContaineroggetto .

(Ereditato da XContainer)
Add(Object[])

Aggiunge il contenuto specificato come elementi figlio di questo XContaineroggetto .

(Ereditato da XContainer)
AddAfterSelf(Object)

Aggiunge il contenuto specificato immediatamente dopo questo nodo.

(Ereditato da XNode)
AddAfterSelf(Object[])

Aggiunge il contenuto specificato immediatamente dopo questo nodo.

(Ereditato da XNode)
AddAnnotation(Object)

Aggiunge un oggetto all'elenco di annotazioni di questo XObjectoggetto .

(Ereditato da XObject)
AddBeforeSelf(Object)

Aggiunge il contenuto specificato immediatamente prima di questo nodo.

(Ereditato da XNode)
AddBeforeSelf(Object[])

Aggiunge il contenuto specificato immediatamente prima di questo nodo.

(Ereditato da XNode)
AddFirst(Object)

Aggiunge il contenuto specificato come primo elemento figlio di questo documento o elemento.

(Ereditato da XContainer)
AddFirst(Object[])

Aggiunge il contenuto specificato come primo elemento figlio di questo documento o elemento.

(Ereditato da XContainer)
Ancestors()

Restituisce una raccolta degli elementi predecessori di questo nodo.

(Ereditato da XNode)
Ancestors(XName)

Restituisce una raccolta filtrata degli elementi predecessori di questo nodo. Nella raccolta sono inclusi solo gli elementi con un XName corrispondente.

(Ereditato da XNode)
Annotation(Type)

Ottiene il primo oggetto annotazione del tipo specificato da questo XObjectoggetto .

(Ereditato da XObject)
Annotation<T>()

Ottiene il primo oggetto annotazione del tipo specificato da questo XObjectoggetto .

(Ereditato da XObject)
Annotations(Type)

Ottiene una raccolta di annotazioni del tipo specificato per questo XObjectoggetto .

(Ereditato da XObject)
Annotations<T>()

Ottiene una raccolta di annotazioni del tipo specificato per questo XObjectoggetto .

(Ereditato da XObject)
CreateReader()

Crea un oggetto XmlReader per questo nodo.

(Ereditato da XNode)
CreateReader(ReaderOptions)

Crea un oggetto XmlReader con le opzioni specificate dal readerOptions parametro .

(Ereditato da XNode)
CreateWriter()

Crea un oggetto XmlWriter che può essere usato per aggiungere nodi all'oggetto XContainer.

(Ereditato da XContainer)
DescendantNodes()

Restituisce un insieme dei nodi discendenti per questo documento o elemento, in ordine di documento.

(Ereditato da XContainer)
Descendants()

Restituisce un insieme di elementi discendenti per questo documento o elemento, in ordine di documento.

(Ereditato da XContainer)
Descendants(XName)

Restituisce un insieme filtrato degli elementi discendenti per questo documento o elemento, in ordine di documento. Nella raccolta sono inclusi solo gli elementi con un XName corrispondente.

(Ereditato da XContainer)
Element(XName)

Ottiene il primo elemento figlio (nell'ordine dei documenti) con l'oggetto specificato XName.

(Ereditato da XContainer)
Elements()

Restituisce un insieme degli elementi figlio di questo elemento o documento, in ordine di documento.

(Ereditato da XContainer)
Elements(XName)

Restituisce un insieme filtrato degli elementi figlio di questo elemento o documento, in ordine di documento. Nella raccolta sono inclusi solo gli elementi con un XName corrispondente.

(Ereditato da XContainer)
ElementsAfterSelf()

Restituisce un insieme degli elementi di pari livello dopo questo nodo, in ordine di documento.

(Ereditato da XNode)
ElementsAfterSelf(XName)

Restituisce una raccolta filtrata degli elementi di pari livello dopo questo nodo, nell'ordine dei documenti. Nella raccolta sono inclusi solo gli elementi con un XName corrispondente.

(Ereditato da XNode)
ElementsBeforeSelf()

Restituisce un insieme degli elementi di pari livello prima di questo nodo, in ordine di documento.

(Ereditato da XNode)
ElementsBeforeSelf(XName)

Restituisce una raccolta filtrata degli elementi di pari livello prima di questo nodo, in ordine di documento. Nella raccolta sono inclusi solo gli elementi con un XName corrispondente.

(Ereditato da XNode)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
IsAfter(XNode)

Determina se il nodo corrente viene visualizzato dopo un nodo specificato in termini di ordine dei documenti.

(Ereditato da XNode)
IsBefore(XNode)

Determina se il nodo corrente viene visualizzato prima di un nodo specificato in termini di ordine documento.

(Ereditato da XNode)
Load(Stream, LoadOptions)

Crea una nuova XDocument istanza usando il flusso specificato, mantenendo facoltativamente lo spazio vuoto, impostando l'URI di base e mantenendo le informazioni sulla riga.
Load(Stream)

Crea una nuova XDocument istanza usando il flusso specificato.
Load(String, LoadOptions)

Crea un nuovo XDocument oggetto da un file, mantenendo facoltativamente lo spazio vuoto, impostando l'URI di base e mantenendo le informazioni sulla riga.
Load(String)

Crea un nuovo XDocument oggetto da un file.
Load(TextReader, LoadOptions)

Crea un nuovo XDocument oggetto da un TextReaderoggetto , mantenendo facoltativamente lo spazio vuoto, impostando l'URI di base e mantenendo le informazioni sulla riga.
Load(TextReader)

Crea un nuovo XDocument oggetto da un oggetto TextReader.
Load(XmlReader, LoadOptions)

Carica un oggetto XDocument da un XmlReaderoggetto , facoltativamente impostando l'URI di base e mantenendo le informazioni sulla riga.
Load(XmlReader)

Crea un nuovo XDocument oggetto da un oggetto XmlReader.
LoadAsync(Stream, LoadOptions, CancellationToken)

Crea in modo asincrono un nuovo XDocument oggetto e inizializza l'albero XML sottostante dal flusso specificato, mantenendo facoltativamente lo spazio vuoto.
LoadAsync(TextReader, LoadOptions, CancellationToken)

Crea un nuovo XDocument oggetto e inizializza l'albero XML sottostante utilizzando il parametro specificato TextReader , mantenendo facoltativamente lo spazio vuoto.
LoadAsync(XmlReader, LoadOptions, CancellationToken)

Crea un nuovo XDocument oggetto contenente il contenuto dell'oggetto specificato XmlReader.
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
Nodes()

Restituisce un insieme dei nodi figlio di questo elemento o documento, in ordine di documento.

(Ereditato da XContainer)
NodesAfterSelf()

Restituisce una raccolta dei nodi di pari livello dopo questo nodo, in ordine di documento.

(Ereditato da XNode)
NodesBeforeSelf()

Restituisce una raccolta dei nodi di pari livello prima di questo nodo, in ordine di documento.

(Ereditato da XNode)
Parse(String, LoadOptions)

Crea un nuovo XDocument oggetto da una stringa, mantenendo facoltativamente lo spazio vuoto, impostando l'URI di base e mantenendo le informazioni sulla riga.
Parse(String)

Crea un nuovo XDocument oggetto da una stringa.
Remove()

Rimuove questo nodo dal relativo elemento padre.

(Ereditato da XNode)
RemoveAnnotations(Type)

Rimuove le annotazioni del tipo specificato da questo XObjectoggetto .

(Ereditato da XObject)
RemoveAnnotations<T>()

Rimuove le annotazioni del tipo specificato da questo XObjectoggetto .

(Ereditato da XObject)
RemoveNodes()

Rimuove i nodi figlio da questo documento o elemento.

(Ereditato da XContainer)
ReplaceNodes(Object)

Sostituisce i nodi figlio di questo documento o elemento con il contenuto specificato.

(Ereditato da XContainer)
ReplaceNodes(Object[])

Sostituisce i nodi figlio di questo documento o elemento con il contenuto specificato.

(Ereditato da XContainer)
ReplaceWith(Object)

Sostituisce questo nodo con il contenuto specificato.

(Ereditato da XNode)
ReplaceWith(Object[])

Sostituisce questo nodo con il contenuto specificato.

(Ereditato da XNode)
Save(Stream, SaveOptions)

Restituisce questo valore XDocument all'oggetto specificato Stream, specificando facoltativamente il comportamento di formattazione.
Save(Stream)

Restituisce l'oggetto XDocument all'oggetto specificato Stream.
Save(String, SaveOptions)

Serializzarlo XDocument in un file, disabilitando facoltativamente la formattazione.
Save(String)

Serializzarlo XDocument in un file, sovrascrivendo un file esistente, se esistente.
Save(TextWriter, SaveOptions)

Serializzarlo XDocument in un TextWriteroggetto , disabilitando facoltativamente la formattazione.
Save(TextWriter)

Serializzarlo XDocument in un oggetto TextWriter.
Save(XmlWriter)

Serializzare l'oggetto XDocument in un oggetto XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)

Restituisce l'output XDocument in un oggetto Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)

Scrive questo oggetto XDocument in un oggetto TextWriter.
SaveAsync(XmlWriter, CancellationToken)

Scrive questo oggetto XDocument in un oggetto XmlWriter.
ToString()

Restituisce il codice XML rientrato per questo nodo.

(Ereditato da XNode)
ToString(SaveOptions)

Restituisce il codice XML per questo nodo, disabilitando facoltativamente la formattazione.

(Ereditato da XNode)
WriteTo(XmlWriter)

Scrivere questo documento in un oggetto XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)

Scrive l'albero XML sottostante di XDocument nell'oggetto specificato XmlWriter.

Eventi

Nome Descrizione
Changed

Generato quando questo XObject o uno dei relativi discendenti sono cambiati.

(Ereditato da XObject)
Changing

Generato quando questo XObject o uno dei relativi discendenti sta per cambiare.

(Ereditato da XObject)

Implementazioni dell'interfaccia esplicita

Nome Descrizione
IXmlLineInfo.HasLineInfo()

Ottiene un valore che indica se contiene XObject o meno informazioni sulla riga.

(Ereditato da XObject)
IXmlLineInfo.LineNumber

Ottiene il numero di riga segnalato dall'oggetto sottostante XmlReader per questo XObjectoggetto .

(Ereditato da XObject)
IXmlLineInfo.LinePosition

Ottiene la posizione della riga segnalata dall'oggetto sottostante XmlReader per questo XObjectoggetto .

(Ereditato da XObject)

Metodi di estensione

Nome Descrizione
CreateNavigator(XNode, XmlNameTable)

Crea un oggetto XPathNavigator per un oggetto XNode. XmlNameTable consente un'elaborazione delle espressioni XPath più efficiente.
CreateNavigator(XNode)

Crea un oggetto XPathNavigator per un oggetto XNode.
ToXPathNavigable(XNode)

Restituisce una funzione di accesso che consente di spostarsi e modificare l'oggetto specificato XNode.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)

Verifica che un oggetto XDocument sia conforme a un XSD in un XmlSchemaSetoggetto , se necessario popolamento dell'albero XML con l'infoset di post-schema-convalida (PSVI).
Validate(XDocument, XmlSchemaSet, ValidationEventHandler)

Questo metodo convalida che un oggetto XDocument è conforme a un XSD in un oggetto XmlSchemaSet.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)

Valuta un'espressione XPath, risolvendo i prefissi dello spazio dei nomi usando l'oggetto specificato IXmlNamespaceResolver.
XPathEvaluate(XNode, String)

Valuta un'espressione XPath.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)

Seleziona un oggetto utilizzando un'espressione XElement XPath, risolvendo i prefissi dello spazio dei nomi usando l'oggetto specificato IXmlNamespaceResolver.
XPathSelectElement(XNode, String)

Seleziona un oggetto utilizzando un'espressione XElement XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)

Seleziona una raccolta di elementi usando un'espressione XPath, risolvendo i prefissi dello spazio dei nomi usando l'oggetto specificato IXmlNamespaceResolver.
XPathSelectElements(XNode, String)

Seleziona una raccolta di elementi utilizzando un'espressione XPath.

Si applica a

Vedi anche