XElement Třída

Definice

Obor názvů:

System.Xml.Linq

Sestavení:

System.Xml.XDocument.dll

Sestavení:

System.Xml.Linq.dll

Sestavení:

netstandard.dll

Představuje element XML. Informace o využití a příklady najdete v části Přehled třídy XElement a poznámky na této stránce.

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

public ref class XElement : System::Xml::Linq::XContainer

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

public class XElement : System.Xml.Linq.XContainer

type XElement = class
    inherit XContainer
    interface IXmlSerializable

type XElement = class
    inherit XContainer

Public Class XElement
Inherits XContainer
Implements IXmlSerializable

Public Class XElement
Inherits XContainer

Dědičnost

Object

XObject

XNode

XContainer

XElement

Implementuje

IXmlSerializable

Příklady

Následující příklad vytvoří strom XML. Obsah nového prvku pochází z dotazu 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)  

Tento příklad vytvoří následující výstup:

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

Následující příklad je stejný, ale v tomto případě je XML v oboru názvů. Další informace naleznete v tématu Práce s obory názvů 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  

Tento příklad vytvoří následující výstup:

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

Poznámky

Tato třída představuje XML element, základní XML konstruktor. Další informace o využití najdete v přehledu třídy XElement .

Prvek má XNamevolitelně jeden nebo více atributů a může volitelně obsahovat obsah (další informace naleznete v tématu Nodes).

Může XElement obsahovat následující typy obsahu:

• XElement

• XComment

• XProcessingInstruction

• XText

Podrobnosti o platném obsahu objektu XElementnaleznete v tématu Platný obsah XElement a objekty XDocument.

XElement odvozuje od XContainer, která je odvozena od XNode.

Některé XElement metody lze použít z XAML. Další informace najdete v tématu LINQ to XML Dynamické vlastnosti.

Konstruktory

XElement(XElement)	Inicializuje novou instanci XElement třídy z jiného XElement objektu.
XElement(XName)	Inicializuje novou instanci XElement třídy se zadaným názvem.
XElement(XName, Object)	Inicializuje novou instanci XElement třídy se zadaným názvem a obsahem.
XElement(XName, Object[])	Inicializuje novou instanci XElement třídy se zadaným názvem a obsahem.
XElement(XStreamingElement)	Inicializuje novou instanci XElement třídy z objektu XStreamingElement .

Vlastnosti

BaseUri	Získá základní identifikátor URI pro tento XObject. (Zděděno od XObject)
Document	XDocument Získá pro to XObject. (Zděděno od XObject)
EmptySequence	Získá prázdnou kolekci prvků.
FirstAttribute	Získá první atribut tohoto prvku.
FirstNode	Získá první podřízený uzel tohoto uzlu. (Zděděno od XContainer)
HasAttributes	Získá hodnotu určující, zda tento prvek má alespoň jeden atribut.
HasElements	Získá hodnotu určující, zda tento prvek má alespoň jeden podřízený prvek.
IsEmpty	Získá hodnotu určující, zda tento prvek neobsahuje žádný obsah.
LastAttribute	Získá poslední atribut tohoto prvku.
LastNode	Získá poslední podřízený uzel tohoto uzlu. (Zděděno od XContainer)
Name	Získá nebo nastaví název tohoto prvku.
NextNode	Získá další uzel na stejné úrovni tohoto uzlu. (Zděděno od XNode)
NodeType	Získá typ uzlu pro tento uzel.
Parent	Získá nadřazený XElement objekt .XObject (Zděděno od XObject)
PreviousNode	Získá předchozí uzel na stejné úrovni tohoto uzlu. (Zděděno od XNode)
Value	Získá nebo nastaví zřetězený textový obsah tohoto prvku.

Metody

Add(Object)	Přidá zadaný obsah jako podřízené položky XContainer. (Zděděno od XContainer)
Add(Object[])	Přidá zadaný obsah jako podřízené položky XContainer. (Zděděno od XContainer)
AddAfterSelf(Object)	Přidá zadaný obsah hned za tímto uzlem. (Zděděno od XNode)
AddAfterSelf(Object[])	Přidá zadaný obsah hned za tímto uzlem. (Zděděno od XNode)
AddAnnotation(Object)	Přidá objekt do seznamu poznámek tohoto XObjectobjektu . (Zděděno od XObject)
AddBeforeSelf(Object)	Přidá zadaný obsah bezprostředně před tento uzel. (Zděděno od XNode)
AddBeforeSelf(Object[])	Přidá zadaný obsah bezprostředně před tento uzel. (Zděděno od XNode)
AddFirst(Object)	Přidá zadaný obsah jako první podřízené položky tohoto dokumentu nebo elementu. (Zděděno od XContainer)
AddFirst(Object[])	Přidá zadaný obsah jako první podřízené položky tohoto dokumentu nebo elementu. (Zděděno od XContainer)
Ancestors()	Vrátí kolekci nadřazených prvků tohoto uzlu. (Zděděno od XNode)
Ancestors(XName)	Vrátí filtrovanou kolekci nadřazených prvků tohoto uzlu. V kolekci jsou zahrnuty pouze prvky, které mají shodu XName . (Zděděno od XNode)
AncestorsAndSelf()	Vrátí kolekci prvků, které obsahují tento prvek, a nadřazené prvky tohoto prvku.
AncestorsAndSelf(XName)	Vrátí filtrovanou kolekci prvků, které tento prvek obsahují, a nadřazené prvky tohoto prvku. V kolekci jsou zahrnuty pouze prvky, které mají shodu XName .
Annotation(Type)	Získá první anotační objekt zadaného typu z tohoto XObject. (Zděděno od XObject)
Annotation<T>()	Získá první anotační objekt zadaného typu z tohoto XObject. (Zděděno od XObject)
Annotations(Type)	Získá kolekci poznámek zadaného typu pro tento XObject. (Zděděno od XObject)
Annotations<T>()	Získá kolekci poznámek zadaného typu pro tento XObject. (Zděděno od XObject)
Attribute(XName)	XAttribute Vrátí hodnotu, XElement která má zadanou XNamehodnotu .
Attributes()	Vrátí kolekci atributů tohoto prvku.
Attributes(XName)	Vrátí filtrovanou kolekci atributů tohoto prvku. V kolekci jsou zahrnuty pouze atributy, které mají shodu XName .
CreateReader()	Vytvoří pro tento uzel příkaz XmlReader . (Zděděno od XNode)
CreateReader(ReaderOptions)	XmlReader Vytvoří s možnostmi určenými parametremreaderOptions. (Zděděno od XNode)
CreateWriter()	XmlWriter Vytvoří, která se dá použít k přidání uzlů do XContainersouboru . (Zděděno od XContainer)
DescendantNodes()	Vrátí kolekci potomků uzlů pro tento dokument nebo prvek v pořadí dokumentů. (Zděděno od XContainer)
DescendantNodesAndSelf()	Vrátí kolekci uzlů, které tento prvek obsahují, a všechny následné uzly tohoto prvku v pořadí dokumentu.
Descendants()	Vrátí kolekci následnických prvků pro tento dokument nebo prvek v pořadí dokumentu. (Zděděno od XContainer)
Descendants(XName)	Vrátí filtrovanou kolekci následnických prvků pro tento dokument nebo prvek v pořadí dokumentů. V kolekci jsou zahrnuty pouze prvky, které mají shodu XName . (Zděděno od XContainer)
DescendantsAndSelf()	Vrátí kolekci prvků, které obsahují tento prvek, a všechny následné prvky tohoto prvku v pořadí dokumentu.
DescendantsAndSelf(XName)	Vrátí filtrovanou kolekci prvků, které tento prvek obsahují, a všechny následné prvky tohoto prvku v pořadí dokumentu. V kolekci jsou zahrnuty pouze prvky, které mají shodu XName .
Element(XName)	Získá první (v pořadí dokumentů) podřízený prvek se zadaným XName. (Zděděno od XContainer)
Elements()	Vrátí kolekci podřízených prvků tohoto prvku nebo dokumentu v pořadí dokumentu. (Zděděno od XContainer)
Elements(XName)	Vrátí filtrovanou kolekci podřízených prvků tohoto prvku nebo dokumentu v pořadí dokumentu. V kolekci jsou zahrnuty pouze prvky, které mají shodu XName . (Zděděno od XContainer)
ElementsAfterSelf()	Vrátí kolekci elementů na stejné úrovni za tímto uzlem v pořadí dokumentů. (Zděděno od XNode)
ElementsAfterSelf(XName)	Vrátí filtrovanou kolekci elementů na stejné úrovni za tímto uzlem v pořadí dokumentů. V kolekci jsou zahrnuty pouze prvky, které mají shodu XName . (Zděděno od XNode)
ElementsBeforeSelf()	Vrátí kolekci elementů na stejné úrovni před tímto uzlem v pořadí dokumentu. (Zděděno od XNode)
ElementsBeforeSelf(XName)	Vrátí filtrovanou kolekci elementů na stejné úrovni před tímto uzlem v pořadí dokumentů. V kolekci jsou zahrnuty pouze prvky, které mají shodu XName . (Zděděno od XNode)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetDefaultNamespace()	Získá výchozí XNamespace hodnotu tohoto XElement.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetNamespaceOfPrefix(String)	Získá obor názvů přidružený k určité předponě pro tento XElement.
GetPrefixOfNamespace(XNamespace)	Získá předponu přidruženou k oboru názvů pro tento XElement.
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
IsAfter(XNode)	Určuje, jestli se aktuální uzel zobrazí za zadaným uzlem z hlediska pořadí dokumentů. (Zděděno od XNode)
IsBefore(XNode)	Určuje, jestli se aktuální uzel zobrazí před zadaným uzlem z hlediska pořadí dokumentů. (Zděděno od XNode)
Load(Stream)	Vytvoří novou XElement instanci pomocí zadaného datového proudu.
Load(Stream, LoadOptions)	Vytvoří novou XElement instanci pomocí zadaného datového proudu, případně zachováním prázdného místa, nastavením základního identifikátoru URI a zachováním informací o řádku.
Load(String)	Načte soubor XElement .
Load(String, LoadOptions)	XElement Načte ze souboru volitelně zachování prázdného místa, nastavení základního identifikátoru URI a zachování informací o řádku.
Load(TextReader)	Načte ze XElement souboru TextReader.
Load(TextReader, LoadOptions)	XElement Načte z TextReader, volitelně zachování prázdných znaků a zachování informací o řádku.
Load(XmlReader)	Načte z objektu XElement XmlReader.
Load(XmlReader, LoadOptions)	XElement Načte z volitelného zachování prázdného XmlReadermísta, nastavení základního identifikátoru URI a zachování informací o řádku.
LoadAsync(Stream, LoadOptions, CancellationToken)	Asynchronně vytvoří nový XElement a inicializuje základní strom XML pomocí zadaného datového proudu, volitelně zachová prázdné místo.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Asynchronně vytvoří nový XElement a inicializuje základní strom XML pomocí zadané čtečky textu, volitelně zachová prázdné místo.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Asynchronně vytvoří nový XElement a inicializuje základní strom XML pomocí zadané čtečky XML, volitelně zachování prázdného místa.
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
Nodes()	Vrátí kolekci podřízených uzlů tohoto prvku nebo dokumentu v pořadí dokumentů. (Zděděno od XContainer)
NodesAfterSelf()	Vrátí kolekci uzlů na stejné úrovni za tímto uzlem v pořadí dokumentu. (Zděděno od XNode)
NodesBeforeSelf()	Vrátí kolekci uzlů na stejné úrovni před tímto uzlem v pořadí dokumentu. (Zděděno od XNode)
Parse(String)	XElement Načtěte z řetězce, který obsahuje XML.
Parse(String, LoadOptions)	XElement Načtěte z řetězce, který obsahuje XML, volitelně zachovává prázdné znaky a zachovává informace o řádku.
Remove()	Odebere tento uzel z nadřazeného objektu. (Zděděno od XNode)
RemoveAll()	Odebere uzly a atributy z tohoto XElementobjektu .
RemoveAnnotations(Type)	Odebere z tohoto XObjecttypu poznámky zadaného typu . (Zděděno od XObject)
RemoveAnnotations<T>()	Odebere z tohoto XObjecttypu poznámky zadaného typu . (Zděděno od XObject)
RemoveAttributes()	Odebere atributy tohoto XElementsouboru .
RemoveNodes()	Odebere podřízené uzly z tohoto dokumentu nebo elementu. (Zděděno od XContainer)
ReplaceAll(Object)	Nahradí podřízené uzly a atributy tohoto prvku zadaným obsahem.
ReplaceAll(Object[])	Nahradí podřízené uzly a atributy tohoto prvku zadaným obsahem.
ReplaceAttributes(Object)	Nahradí atributy tohoto prvku zadaným obsahem.
ReplaceAttributes(Object[])	Nahradí atributy tohoto prvku zadaným obsahem.
ReplaceNodes(Object)	Nahradí podřízené uzly tohoto dokumentu nebo elementu zadaným obsahem. (Zděděno od XContainer)
ReplaceNodes(Object[])	Nahradí podřízené uzly tohoto dokumentu nebo elementu zadaným obsahem. (Zděděno od XContainer)
ReplaceWith(Object)	Nahradí tento uzel zadaným obsahem. (Zděděno od XNode)
ReplaceWith(Object[])	Nahradí tento uzel zadaným obsahem. (Zděděno od XNode)
Save(Stream)	Výstupem je XElement zadaný Stream.
Save(Stream, SaveOptions)	Vypíše tento XElement údaj do zadaného Stream, volitelně specifikuje chování formátování.
Save(String)	Serializovat tento prvek do souboru.
Save(String, SaveOptions)	Serializovat tento prvek do souboru, volitelně zakázání formátování.
Save(TextWriter)	Serializace tohoto prvku na TextWriter.
Save(TextWriter, SaveOptions)	Serializace tohoto prvku na TextWriter, volitelné zakázání formátování.
Save(XmlWriter)	Serializace tohoto prvku na XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)	Asynchronně to XElement vypíše do .Stream
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Asynchronně to XElement vypíše do .TextWriter
SaveAsync(XmlWriter, CancellationToken)	Asynchronně to XElement vypíše do objektu XmlWriter.
SetAttributeValue(XName, Object)	Nastaví hodnotu atributu, přidá atribut nebo odebere atribut.
SetElementValue(XName, Object)	Nastaví hodnotu podřízeného elementu, přidá podřízený prvek nebo odebere podřízený prvek.
SetValue(Object)	Nastaví hodnotu tohoto prvku.
ToString()	Vrátí odsazený KÓD XML pro tento uzel. (Zděděno od XNode)
ToString(SaveOptions)	Vrátí xml pro tento uzel, volitelně zakázání formátování. (Zděděno od XNode)
WriteTo(XmlWriter)	Napište tento prvek do objektu XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Asynchronně to XElement zapisuje do zadaného zapisovače.
WriteToAsync(XmlWriter, CancellationToken)	Zapíše aktuální uzel do objektu XmlWriter. (Zděděno od XNode)

Operátory

Explicit(XElement to Boolean)	Přetypujte hodnotu na XElement Booleanhodnotu .
Explicit(XElement to DateTime)	Přetypujte hodnotu na XElement DateTimehodnotu .
Explicit(XElement to DateTimeOffset)	Přetypujte hodnotu na XAttribute DateTimeOffsethodnotu .
Explicit(XElement to Decimal)	Přetypujte hodnotu na XElement Decimalhodnotu .
Explicit(XElement to Double)	Přetypujte hodnotu na XElement Doublehodnotu .
Explicit(XElement to Guid)	Přetypujte hodnotu na XElement Guidhodnotu .
Explicit(XElement to Int32)	Přetypujte hodnotu na XElement Int32hodnotu .
Explicit(XElement to Int64)	Přetypujte hodnotu na XElement Int64hodnotu .
Explicit(XElement to Nullable<Boolean>)	Přetypujte hodnotu XElement Nullable<T> na hodnotu .Boolean
Explicit(XElement to Nullable<DateTime>)	Přetypujte hodnotu XElement Nullable<T> na hodnotu .DateTime
Explicit(XElement to Nullable<DateTimeOffset>)	Přetypujte hodnotu XElement Nullable<T> na hodnotu .DateTimeOffset
Explicit(XElement to Nullable<Decimal>)	Přetypujte hodnotu XElement Nullable<T> na hodnotu .Decimal
Explicit(XElement to Nullable<Double>)	Přetypujte hodnotu XElement Nullable<T> na hodnotu .Double
Explicit(XElement to Nullable<Guid>)	Přetypujte hodnotu XElement Nullable<T> na hodnotu .Guid
Explicit(XElement to Nullable<Int32>)	Přetypujte hodnotu XElement Nullable<T> na hodnotu .Int32
Explicit(XElement to Nullable<Int64>)	Přetypujte hodnotu XElement Nullable<T> na hodnotu .Int64
Explicit(XElement to Nullable<Single>)	Přetypujte hodnotu XElement Nullable<T> na hodnotu .Single
Explicit(XElement to Nullable<TimeSpan>)	Přetypujte hodnotu XElement Nullable<T> na hodnotu .TimeSpan
Explicit(XElement to Nullable<UInt32>)	Přetypujte hodnotu XElement Nullable<T> na hodnotu .UInt32
Explicit(XElement to Nullable<UInt64>)	Přetypujte hodnotu XElement Nullable<T> na hodnotu .UInt64
Explicit(XElement to Single)	Přetypujte hodnotu této XElement hodnoty na Singlehodnotu .
Explicit(XElement to String)	Přetypujte hodnotu této XElement hodnoty na Stringhodnotu .
Explicit(XElement to TimeSpan)	Přetypujte hodnotu této XElement hodnoty na TimeSpanhodnotu .
Explicit(XElement to UInt32)	Přetypujte hodnotu této XElement hodnoty na UInt32hodnotu .
Explicit(XElement to UInt64)	Přetypujte hodnotu této XElement hodnoty na UInt64hodnotu .

událost

Changed	Vyvolá se, když se tento XObject nebo některý z jeho potomků změnil. (Zděděno od XObject)
Changing	Vyvolá se, když se to XObject nebo některý z jejích potomků chystá změnit. (Zděděno od XObject)

Explicitní implementace rozhraní

IXmlLineInfo.HasLineInfo()	Získá hodnotu označující, zda má tento XObject řádek informace. (Zděděno od XObject)
IXmlLineInfo.LineNumber	Získá číslo řádku, které podkladové XmlReader hlášení pro tento XObject. (Zděděno od XObject)
IXmlLineInfo.LinePosition	Získá pozici čáry, kterou podklad XmlReader hlášen pro tento XObject. (Zděděno od XObject)
IXmlSerializable.GetSchema()	Získá definici schématu XML, která popisuje reprezentaci XML tohoto objektu.
IXmlSerializable.ReadXml(XmlReader)	Generuje objekt z reprezentace XML.
IXmlSerializable.WriteXml(XmlWriter)	Převede objekt na jeho reprezentaci XML.

Metody rozšíření

GetSchemaInfo(XElement)	Získá po schema-validation infoset (PSVI) ověřeného elementu.
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)	Tato metoda ověří, že XElement dílčí strom odpovídá zadanému a určitému XmlSchemaObject XmlSchemaSetstromu .
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)	Ověří, že podsložka XElement odpovídá zadanému XmlSchemaObject stromu a XmlSchemaSetvolitelně naplní strom XML sadou informací o ověření schématu (PSVI).
CreateNavigator(XNode)	XPathNavigator Vytvoří pro objekt XNode.
CreateNavigator(XNode, XmlNameTable)	XPathNavigator Vytvoří pro objekt XNode. Umožňuje XmlNameTable efektivnější zpracování výrazů XPath.
XPathEvaluate(XNode, String)	Vyhodnotí výraz XPath.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	Vyhodnotí výraz XPath a přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolvervýrazu .
XPathSelectElement(XNode, String)	XElement Vybere výraz XPath.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	XElement Vybere výraz XPath, přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolvervýrazu .
XPathSelectElements(XNode, String)	Vybere kolekci prvků pomocí výrazu XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Vybere kolekci prvků pomocí výrazu XPath a přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolvervýrazu .
ToXPathNavigable(XNode)	Vrátí přístupový objekt, který umožňuje navigaci a úpravě zadaného objektu XNode.

Viz také

• Přehled LINQ to XML
• Dynamické vlastnosti LINQ to XML