XDocument Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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::XContainerpublic class XDocument : System.Xml.Linq.XContainertype XDocument = class
inherit XContainerPublic Class XDocument
Inherits XContainer- Ereditarietà
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 |
| 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) | |
| 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) | |
| SaveAsync(Stream, SaveOptions, CancellationToken) | |
| SaveAsync(TextWriter, SaveOptions, CancellationToken) |
Scrive questo XDocument in un oggetto TextWriter. |
| SaveAsync(XmlWriter, CancellationToken) | |
| 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. |
| WriteToAsync(XmlWriter, CancellationToken) |
Scrive il nodo corrente in un XmlWriter. (Ereditato da XNode) |
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. |
