XElement Classe

Definizione

Spazio dei nomi:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Origine:

XElement.cs

Rappresenta un elemento XML. Per informazioni sull'uso e per esempi, vedere Panoramica della classe XElement e la sezione Osservazioni in questa pagina.

public ref class XElement : System::Xml::Linq::XContainer, System::Xml::Serialization::IXmlSerializable

public class XElement : System.Xml.Linq.XContainer, System.Xml.Serialization.IXmlSerializable

type XElement = class
    inherit XContainer
    interface IXmlSerializable

Public Class XElement
Inherits XContainer
Implements IXmlSerializable

Ereditarietà

Object

XObject

XNode

XContainer

XElement

Implementazioni

IXmlSerializable

Esempio

Nell'esempio seguente viene creato un albero XML. Il contenuto del nuovo elemento proviene da una query LINQ.

XElement xmlTree1 = new XElement("Root",
    new XElement("Child1", 1),
    new XElement("Child2", 2),
    new XElement("Child3", 3),
    new XElement("Child4", 4),
    new XElement("Child5", 5),
    new XElement("Child6", 6)
);

XElement xmlTree2 = new XElement("Root",
    from el in xmlTree1.Elements()
    where((int)el >= 3 && (int)el <= 5)
    select el
);
Console.WriteLine(xmlTree2);

Dim xmlTree1 As XElement = _
        <Root>
            <Child1>1</Child1>
            <Child2>2</Child2>
            <Child3>3</Child3>
            <Child4>4</Child4>
            <Child5>5</Child5>
            <Child6>6</Child6>
        </Root>

Dim xmlTree2 As XElement = _
    <Root>
        <%= From el In xmlTree1.Elements() _
            Where el.Value >= 3 And el.Value <= 5 _
            Select el %>
    </Root>

Console.WriteLine(xmlTree2)

Nell'esempio viene prodotto l'output seguente:

<Root>
  <Child3>3</Child3>
  <Child4>4</Child4>
  <Child5>5</Child5>
</Root>

Di seguito è riportato lo stesso esempio, ma in questo caso il codice XML si trova in uno spazio dei nomi. Per altre informazioni, vedere Usare gli spazi dei nomi XML.

XNamespace aw = "http://www.adventure-works.com";
XElement xmlTree1 = new XElement(aw + "Root",
    new XElement(aw + "Child1", 1),
    new XElement(aw + "Child2", 2),
    new XElement(aw + "Child3", 3),
    new XElement(aw + "Child4", 4),
    new XElement(aw + "Child5", 5),
    new XElement(aw + "Child6", 6)
);

XElement xmlTree2 = new XElement(aw + "Root",
    from el in xmlTree1.Elements()
    where((int)el >= 3 && (int)el <= 5)
    select el
);
Console.WriteLine(xmlTree2);

Imports <xmlns="http://www.adventure-works.com">

Module Module1
    Sub Main()
        Dim xmlTree1 As XElement = _
            <Root>
                <Child1>1</Child1>
                <Child2>2</Child2>
                <Child3>3</Child3>
                <Child4>4</Child4>
                <Child5>5</Child5>
                <Child6>6</Child6>
            </Root>

        Dim xmlTree2 As XElement = _
            <Root>
                <%= From el In xmlTree1.Elements() _
                    Where el.Value >= 3 And el.Value <= 5 _
                    Select el %>
            </Root>

        Console.WriteLine(xmlTree2)
    End SUb
End Module

Nell'esempio viene prodotto l'output seguente:

<Root xmlns="http://www.adventure-works.com">
  <Child3>3</Child3>
  <Child4>4</Child4>
  <Child5>5</Child5>
</Root>

Commenti

Questa classe rappresenta un elemento XML, il costrutto XML fondamentale. Per altre informazioni sull'utilizzo, vedere Panoramica della classe XElement .

Un elemento include , XNamefacoltativamente, uno o più attributi e può facoltativamente contenere contenuto (per altre informazioni, vedere Nodes).

Un XElement oggetto può contenere i tipi di contenuto seguenti:

• XElement

• XComment

• XProcessingInstruction

• XText

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

XElement deriva da XContainer, che deriva da XNode.

Alcuni XElement metodi possono essere usati da XAML. Per altre informazioni, vedere Proprietà dinamiche di LINQ to XML.

Costruttori

XElement(XElement)	Inizializza una nuova istanza della classe XElement con un altro oggetto XElement.
XElement(XName)	Inizializza una nuova istanza della classe XElement con il nome specificato.
XElement(XName, Object)	Inizializza una nuova istanza della classe XElement con il nome e il contenuto specificati.
XElement(XName, Object[])	Inizializza una nuova istanza della classe XElement con il nome e il contenuto specificati.
XElement(XStreamingElement)	Inizializza una nuova istanza della classe XElement con un oggetto XStreamingElement.

Proprietà

BaseUri	Ottiene l'URI di base per XObject. (Ereditato da XObject)
Document	Ottiene l'oggetto XDocument per l'oggetto XObject. (Ereditato da XObject)
EmptySequence	Ottiene una raccolta vuota di elementi.
FirstAttribute	Ottiene il primo attributo di questo elemento.
FirstNode	Ottiene il primo nodo figlio del nodo. (Ereditato da XContainer)
HasAttributes	Ottiene un valore che indica se questo elemento ha almeno un attributo.
HasElements	Ottiene un valore che indica se l'elemento ha almeno un elemento figlio.
IsEmpty	Ottiene un valore che indica se questo elemento non include contenuto.
LastAttribute	Ottiene l'ultimo attributo di questo elemento.
LastNode	Ottiene l'ultimo nodo figlio del nodo. (Ereditato da XContainer)
Name	Ottiene o imposta il nome di questo elemento.
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)
Value	Ottiene o imposta i contenuti di testo concatenati di questo elemento.

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)
AncestorsAndSelf()	Restituisce una raccolta di elementi che contengono questo elemento e i relativi predecessori.
AncestorsAndSelf(XName)	Restituisce una raccolta filtrata di elementi che contengono questo elemento e i relativi predecessori. Solo gli elementi che hanno un oggetto XName corrispondente vengono inclusi nella raccolta.
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)
Attribute(XName)	Restituisce XAttribute di questo oggetto XElement con l'oggetto XName specificato.
Attributes()	Restituisce una raccolta di attributi di questo elemento.
Attributes(XName)	Restituisce una raccolta filtrata di attributi di questo elemento. Solo gli attributi che hanno un oggetto XName corrispondente vengono inclusi nella raccolta.
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)
DescendantNodesAndSelf()	Restituisce una raccolta di nodi che contengono questo elemento e tutti i relativi nodi discendenti, nell'ordine del documento.
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)
DescendantsAndSelf()	Restituisce una raccolta di elementi che contengono questo elemento e tutti i relativi elementi discendenti, nell'ordine del documento.
DescendantsAndSelf(XName)	Restituisce una raccolta filtrata di elementi che contengono questo elemento e tutti i relativi elementi discendenti, nell'ordine del documento. Solo gli elementi che hanno un oggetto XName corrispondente vengono inclusi nella raccolta.
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)
GetDefaultNamespace()	Ottiene l'oggetto XNamespace predefinito di XElement.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetNamespaceOfPrefix(String)	Ottiene lo spazio dei nomi associato a uno specifico prefisso per XElement.
GetPrefixOfNamespace(XNamespace)	Ottiene il prefisso associato allo spazio dei nomi per XElement.
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 XElement usando il flusso specificato.
Load(Stream, LoadOptions)	Crea una nuova istanza di XElement usando il flusso specificato, conservando facoltativamente lo spazio vuoto, impostando l'URI di base e mantenendo le informazioni sulla riga.
Load(String)	Carica un oggetto XElement da un file.
Load(String, LoadOptions)	Carica XElement da un file, facoltativamente preservando lo spazio vuoto, impostando l'URI di base e mantenendo le informazioni sulla riga.
Load(TextReader)	Carica un oggetto XElement da TextReader.
Load(TextReader, LoadOptions)	Carica XElement da un oggetto TextReader, facoltativamente preservando lo spazio e mantenendo le informazioni sulla riga.
Load(XmlReader)	Carica un oggetto XElement da XmlReader.
Load(XmlReader, LoadOptions)	Carica XElement da un oggetto XmlReader, facoltativamente preservando lo spazio, impostando l'URI di base e mantenendo le informazioni sulla riga.
LoadAsync(Stream, LoadOptions, CancellationToken)	Crea un nuovo XElement in modo asincrono e ne inizializza la struttura ad albero XML sottostante usando il flusso specificato, mantenendo facoltativamente lo spazio vuoto.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Crea un nuovo XElement in modo asincrono e ne inizializza la struttura ad albero XML sottostante usando il lettore di testo specificato, mantenendo facoltativamente lo spazio vuoto.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Crea un nuovo XElement in modo asincrono e ne inizializza la struttura ad albero XML sottostante usando il lettore XML specificato, mantenendo facoltativamente lo spazio vuoto.
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)	Carica un oggetto XElement da una stringa che contiene XML.
Parse(String, LoadOptions)	Carica un oggetto XElement da una stringa contenente XML, facoltativamente preservando lo spazio vuoto e mantenendo le informazioni sulla riga.
Remove()	Rimuove questo nodo dal padre. (Ereditato da XNode)
RemoveAll()	Rimuove i nodi e gli attributi da XElement.
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)
RemoveAttributes()	Rimuove gli attributi di XElement.
RemoveNodes()	Rimuove i nodi figlio da questo documento o elemento. (Ereditato da XContainer)
ReplaceAll(Object)	Sostituisce i nodi figlio e gli attributi di questo elemento con il contenuto specificato.
ReplaceAll(Object[])	Sostituisce i nodi figlio e gli attributi di questo elemento con il contenuto specificato.
ReplaceAttributes(Object)	Sostituisce gli attributi di questo elemento con il contenuto specificato.
ReplaceAttributes(Object[])	Sostituisce gli attributi di questo elemento con il contenuto specificato.
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 XElement nell'oggetto Stream specificato.
Save(Stream, SaveOptions)	Restituisce l'oggetto XElement nell'oggetto Stream specificato, indicando facoltativamente il comportamento di formattazione.
Save(String)	Serializza questo elemento in un file.
Save(String, SaveOptions)	Serializza questo elemento in un file, facoltativamente disabilitando la formattazione.
Save(TextWriter)	Serializza questo elemento in TextWriter.
Save(TextWriter, SaveOptions)	Serializza questo elemento in TextWriter, facoltativamente disabilitando la formattazione.
Save(XmlWriter)	Serializza questo elemento in XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)	Restituisce questo oggetto XElement in un oggetto Stream in modo asincrono.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Restituisce questo oggetto XElement in un oggetto TextWriter in modo asincrono.
SaveAsync(XmlWriter, CancellationToken)	Restituisce questo oggetto XElement in un oggetto XmlWriter in modo asincrono.
SetAttributeValue(XName, Object)	Imposta il valore di un attributo oppure lo aggiunge o lo rimuove.
SetElementValue(XName, Object)	Imposta il valore di un elemento figlio oppure lo aggiunge o lo rimuove.
SetValue(Object)	Imposta il valore dell'elemento.
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)	Scrive l'elemento in XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Scrive questo oggetto XElement nel writer specificato in modo asincrono.

Operatori

Explicit(XElement to Boolean)	Esegue il cast del valore dell'oggetto XElement a un oggetto Boolean.
Explicit(XElement to DateTime)	Esegue il cast del valore dell'oggetto XElement a un oggetto DateTime.
Explicit(XElement to DateTimeOffset)	Esegue il cast del valore dell'oggetto XAttribute a un oggetto DateTimeOffset.
Explicit(XElement to Decimal)	Esegue il cast del valore dell'oggetto XElement a un oggetto Decimal.
Explicit(XElement to Double)	Esegue il cast del valore dell'oggetto XElement a un oggetto Double.
Explicit(XElement to Guid)	Esegue il cast del valore dell'oggetto XElement a un oggetto Guid.
Explicit(XElement to Int32)	Esegue il cast del valore dell'oggetto XElement a un oggetto Int32.
Explicit(XElement to Int64)	Esegue il cast del valore dell'oggetto XElement a un oggetto Int64.
Explicit(XElement to Nullable<Boolean>)	Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Boolean.
Explicit(XElement to Nullable<DateTime>)	Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di DateTime.
Explicit(XElement to Nullable<DateTimeOffset>)	Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di DateTimeOffset.
Explicit(XElement to Nullable<Decimal>)	Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Decimal.
Explicit(XElement to Nullable<Double>)	Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Double.
Explicit(XElement to Nullable<Guid>)	Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Guid.
Explicit(XElement to Nullable<Int32>)	Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Int32.
Explicit(XElement to Nullable<Int64>)	Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Int64.
Explicit(XElement to Nullable<Single>)	Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Single.
Explicit(XElement to Nullable<TimeSpan>)	Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di TimeSpan.
Explicit(XElement to Nullable<UInt32>)	Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di UInt32.
Explicit(XElement to Nullable<UInt64>)	Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di UInt64.
Explicit(XElement to Single)	Esegue il cast del valore dell'oggetto XElement a un oggetto Single.
Explicit(XElement to String)	Esegue il cast del valore dell'oggetto XElement a un oggetto String.
Explicit(XElement to TimeSpan)	Esegue il cast del valore dell'oggetto XElement a un oggetto TimeSpan.
Explicit(XElement to UInt32)	Esegue il cast del valore dell'oggetto XElement a un oggetto UInt32.
Explicit(XElement to UInt64)	Esegue il cast del valore dell'oggetto XElement a un oggetto UInt64.

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)
IXmlSerializable.GetSchema()	Ottiene una definizione XML Schema che descrive la rappresentazione XML di questo oggetto.
IXmlSerializable.ReadXml(XmlReader)	Genera un oggetto dalla relativa rappresentazione XML.
IXmlSerializable.WriteXml(XmlWriter)	Converte un oggetto nella relativa rappresentazione XML.

Metodi di estensione

GetSchemaInfo(XElement)	Ottiene l'infoset dopo la convalida dello schema (PSVI) di un elemento convalidato.
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)	Questo metodo convalida che una sottostruttura XElement è conforme a un XmlSchemaObject e a un XmlSchemaSet.
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)	Convalida che una sottostruttura XElement è conforme a un XmlSchemaObject specificato e a 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

• Panoramica di LINQ to XML
• Proprietà dinamiche in LINQ to XML