XDocument Classe

Definizione

Spazio dei nomi:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Origine:

XDocument.cs

Rappresenta un documento XML. Per informazioni sui componenti e l'uso di un oggetto XDocument, 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)

Nell'esempio viene prodotto 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 XDocumentoggetto , vedere Contenuto valido di oggetti XElement e XDocument.

Costruttori

XDocument()	Inizializza una nuova istanza della classe XDocument.
XDocument(Object[])	Inizializza una nuova istanza della classe XDocument con il contenuto specificato.
XDocument(XDeclaration, Object[])	Inizializza una nuova istanza della classe XDocument con l'oggetto XDeclaration e il contenuto specificati.
XDocument(XDocument)	Inizializza una nuova istanza della classe XDocument da un oggetto XDocument esistente.

Proprietà

BaseUri	Ottiene l'URI di base per XObject. (Ereditato da XObject)
Declaration	Ottiene o imposta la dichiarazione XML del documento.
Document	Ottiene l'oggetto XDocument per l'oggetto XObject. (Ereditato da XObject)
DocumentType	Ottiene la definizione DTD (Document Type Definition) per il documento.
FirstNode	Ottiene il primo nodo figlio del nodo. (Ereditato da XContainer)
LastNode	Ottiene l'ultimo nodo figlio del 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 di 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 del documento.

Metodi

Add(Object)	Aggiunge il contenuto specificato come figlio del XContainer. (Ereditato da XContainer)
Add(Object[])	Aggiunge il contenuto specificato come figlio del XContainer. (Ereditato da XContainer)
AddAfterSelf(Object)	Aggiunge il contenuto specificato immediatamente dopo il nodo. (Ereditato da XNode)
AddAfterSelf(Object[])	Aggiunge il contenuto specificato immediatamente dopo il nodo. (Ereditato da XNode)
AddAnnotation(Object)	Aggiunge un oggetto all'elenco di annotazioni di XObject. (Ereditato da XObject)
AddBeforeSelf(Object)	Aggiunge il contenuto specificato immediatamente prima del nodo. (Ereditato da XNode)
AddBeforeSelf(Object[])	Aggiunge il contenuto specificato immediatamente prima del nodo. (Ereditato da XNode)
AddFirst(Object)	Aggiunge il contenuto specificato come primi figli di questo documento o elemento. (Ereditato da XContainer)
AddFirst(Object[])	Aggiunge il contenuto specificato come primi figli di questo documento o elemento. (Ereditato da XContainer)
Ancestors()	Restituisce una raccolta di elementi predecessori del nodo. (Ereditato da XNode)
Ancestors(XName)	Restituisce una raccolta filtrata di elementi predecessori del nodo. Solo gli elementi che hanno un oggetto XName corrispondente vengono inclusi nella raccolta. (Ereditato da XNode)
Annotation(Type)	Ottiene il primo oggetto annotazione del tipo specificato da XObject. (Ereditato da XObject)
Annotation<T>()	Ottiene il primo oggetto annotazione del tipo specificato da XObject. (Ereditato da XObject)
Annotations(Type)	Ottiene una raccolta di annotazioni del tipo specificato per XObject. (Ereditato da XObject)
Annotations<T>()	Ottiene una raccolta di annotazioni del tipo specificato per XObject. (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 parametro readerOptions. (Ereditato da XNode)
CreateWriter()	Viene creato un oggetto XmlWriter che può essere utilizzato per aggiungere nodi al XContainer. (Ereditato da XContainer)
DescendantNodes()	Restituisce una raccolta di nodi discendenti del documento o elemento nell'ordine dei documenti. (Ereditato da XContainer)
Descendants()	Restituisce una raccolta di elementi discendenti del documento o elemento nell'ordine dei documenti. (Ereditato da XContainer)
Descendants(XName)	Restituisce una raccolta filtrata degli elementi discendenti di questo documento o elemento nell'ordine dei documenti. Solo gli elementi che hanno un oggetto XName corrispondente vengono inclusi nella raccolta. (Ereditato da XContainer)
Element(XName)	Ottiene il primo elemento figlio (nell'ordine dei documenti) con il valore XName specificato. (Ereditato da XContainer)
Elements()	Restituisce una raccolta degli elementi figlio dell'elemento o documento nell'ordine dei documenti. (Ereditato da XContainer)
Elements(XName)	Restituisce una raccolta filtrata degli elementi figlio di questo elemento o documento nell'ordine dei documenti. Solo gli elementi che hanno un oggetto XName corrispondente vengono inclusi nella raccolta. (Ereditato da XContainer)
ElementsAfterSelf()	Restituisce una raccolta di elementi di pari livello dopo questo nodo nell'ordine del documento. (Ereditato da XNode)
ElementsAfterSelf(XName)	Restituisce una raccolta filtrata di elementi di pari livello dopo questo nodo nell'ordine indicato nel documento. Solo gli elementi che hanno un oggetto XName corrispondente vengono inclusi nella raccolta. (Ereditato da XNode)
ElementsBeforeSelf()	Restituisce una raccolta di elementi di pari livello prima di questo nodo nell'ordine del documento. (Ereditato da XNode)
ElementsBeforeSelf(XName)	Restituisce una raccolta filtrata di elementi di pari livello prima di questo nodo nell'ordine del documento. Solo gli elementi che hanno un oggetto XName corrispondente vengono inclusi nella raccolta. (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 l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsAfter(XNode)	Determina se il nodo corrente viene visualizzato dopo un nodo specificato in termini di ordine del documento. (Ereditato da XNode)
IsBefore(XNode)	Determina se il nodo corrente viene visualizzato prima di un nodo specificato in termini di ordine del documento. (Ereditato da XNode)
Load(Stream)	Crea una nuova istanza di XDocument usando il flusso specificato.
Load(Stream, LoadOptions)	Crea una nuova istanza di XDocument usando il flusso specificato, conservando facoltativamente lo spazio vuoto, impostando l'URI di base e mantenendo le informazioni sulla riga.
Load(String)	Crea un oggetto XDocument nuovo da un file.
Load(String, LoadOptions)	Crea un XDocument nuovo da un file, conservando facoltativamente spazio vuoto, impostando l'URI di base e mantenendo le informazioni sulla riga.
Load(TextReader)	Crea un nuovo oggetto XDocument da un oggetto TextReader.
Load(TextReader, LoadOptions)	Crea un XDocument nuovo da un oggetto TextReader, conservando facoltativamente spazio vuoto, impostando l'URI di base e mantenendo le informazioni sulla riga.
Load(XmlReader)	Crea un nuovo oggetto XDocument da un oggetto XmlReader.
Load(XmlReader, LoadOptions)	Carica un XDocument da un XmlReader, impostando facoltativamente l'URI di base e mantenendo le informazioni sulla riga.
LoadAsync(Stream, LoadOptions, CancellationToken)	Crea un nuovo XDocument in modo asincrono e ne inizializza la struttura ad albero XML sottostante dal flusso specificato, mantenendo facoltativamente lo spazio vuoto.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Crea un nuovo oggetto XDocument e ne inizializza la struttura ad albero XML sottostante usando il parametro TextReader specificato, mantenendo facoltativamente lo spazio vuoto.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Crea un nuovo oggetto XDocument che include il contenuto dell'oggetto XmlReader specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Nodes()	Restituisce una raccolta dei nodi figlio dell'elemento o documento nell'ordine dei documenti. (Ereditato da XContainer)
NodesAfterSelf()	Restituisce una raccolta di nodi di pari livello dopo questo nodo nell'ordine del documento. (Ereditato da XNode)
NodesBeforeSelf()	Restituisce una raccolta di nodi di pari livello prima di questo nodo nell'ordine del documento. (Ereditato da XNode)
Parse(String)	Crea un nuovo oggetto XDocument da una stringa.
Parse(String, LoadOptions)	Crea un XDocument nuovo da un stringa, conservando facoltativamente spazio vuoto, impostando l'URI di base e mantenendo le informazioni sulla riga.
Remove()	Rimuove questo nodo dal padre. (Ereditato da XNode)
RemoveAnnotations(Type)	Rimuove le annotazioni del tipo specificato da XObject. (Ereditato da XObject)
RemoveAnnotations<T>()	Rimuove le annotazioni del tipo specificato da XObject. (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)	Restituisce l'oggetto XDocument nell'oggetto Stream specificato.
Save(Stream, SaveOptions)	Restituisce l'oggetto XDocument nell'oggetto Stream specificato, indicando facoltativamente il comportamento di formattazione.
Save(String)	Serializza questo oggetto XDocument in un file sovrascrivendo un file esistente, se esiste.
Save(String, SaveOptions)	Serializzare XDocument in un file, disabilitando facoltativamente la formattazione.
Save(TextWriter)	Serializzare XDocument in un TextWriter.
Save(TextWriter, SaveOptions)	Serializzare XDocument in un TextWriter, disabilitando facoltativamente la formattazione.
Save(XmlWriter)	Serializzare XDocument in un XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)	Restituisce questo XDocument in un oggetto Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Scrive questo XDocument in un oggetto TextWriter.
SaveAsync(XmlWriter, CancellationToken)	Scrive questo XDocument in un oggetto XmlWriter.
ToString()	Restituisce il codice XML con rientro per questo nodo. (Ereditato da XNode)
ToString(SaveOptions)	Restituisce il codice XML per questo nodo, facoltativamente disabilitando la formattazione. (Ereditato da XNode)
WriteTo(XmlWriter)	Scrivere il documento in un XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Scrive l'albero XML sottostante di questo XDocument nell'oggetto XmlWriter specificato.

Eventi

Changed	Viene generato quando XObject o uno dei discendenti viene modificato. (Ereditato da XObject)
Changing	Viene generato quando XObject o uno dei discendenti sta per essere modificato. (Ereditato da XObject)

Implementazioni dell'interfaccia esplicita

IXmlLineInfo.HasLineInfo()	Ottiene un valore che indica se XObject contiene o meno informazioni sulla riga. (Ereditato da XObject)
IXmlLineInfo.LineNumber	Ottiene il numero di riga che il XmlReader sottostante ha riportato per XObject. (Ereditato da XObject)
IXmlLineInfo.LinePosition	Ottiene il numero di posizione che il XmlReader sottostante ha riportato per XObject. (Ereditato da XObject)

Metodi di estensione

Validate(XDocument, XmlSchemaSet, ValidationEventHandler)	Questo metodo convalida che un XDocument è conforme a uno schema XSD in un XmlSchemaSet.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)	Convalida che un XDocument è conforme a uno schema XSD in un XmlSchemaSet, popolando facoltativamente la struttura ad albero XML con l'infoset dopo la convalida dello schema (PSVI).
CreateNavigator(XNode)	Crea un oggetto XPathNavigator per XNode.
CreateNavigator(XNode, XmlNameTable)	Crea un oggetto XPathNavigator per XNode. XmlNameTable attiva un'elaborazione più efficiente delle espressioni XPath.
XPathEvaluate(XNode, String)	Valuta un'espressione XPath.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	Valuta un'espressione XPath risolvendo i prefissi degli spazi dei nomi utilizzando l'oggetto IXmlNamespaceResolver specificato.
XPathSelectElement(XNode, String)	Viene selezionato XElement utilizzando un'espressione XPath.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	Viene selezionato XElement utilizzando un'espressione XPath e risolvendo i prefissi degli spazi dei nomi tramite l'oggetto IXmlNamespaceResolver specificato.
XPathSelectElements(XNode, String)	Seleziona una raccolta di elementi utilizzando un'espressione XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Viene selezionata una raccolta di elementi utilizzando un'espressione XPath e risolvendo i prefissi degli spazi dei nomi tramite l'oggetto IXmlNamespaceResolver specificato.
ToXPathNavigable(XNode)	Restituisce una funzione di accesso che consente di esplorare e modificare l'oggetto XNode specificato.

Vedi anche

• XNamespace
• XDeclaration
• XElement
• XNode
• Panoramica di LINQ to XML
• Panoramica della classe XDocument