XElement Třída

Definice

Obor názvů:

System.Xml.Linq

Sestavení:

System.Xml.XDocument.dll

Zdroj:

XElement.cs

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

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

Dědičnost

Object

XObject

XNode

XContainer

XElement

Implementuje

IXmlSerializable

Příklady

Následující příklad vytvoří strom XML. Obsah nového elementu 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ásleduje stejný příklad, ale v tomto případě je XML v oboru názvů. Další informace najdete 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 element XML, základní konstruktor XML. Další informace o použití najdete v tématu Přehled třídy XElement .

Element má XName, volitelně jeden nebo více atributů a volitelně může obsahovat obsah (další informace najdete v tématu Nodes).

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

• XElement

• XComment

• XProcessingInstruction

• XText

Podrobnosti o platném obsahu objektu najdete v XElementtématu Platný obsah objektů XElement a XDocument.

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

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

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	Získá pro XDocument tento XObjectobjekt . (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 označující, zda má tento prvek alespoň jeden atribut.
HasElements	Získá hodnotu označující, zda má tento prvek alespoň jeden podřízený prvek.
IsEmpty	Získá hodnotu označ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 tohoto XObjectobjektu . (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í obsah zřetězení textu tohoto prvku.

Metody

Add(Object)	Přidá zadaný obsah jako podřízené položky tohoto XContainersouboru . (Zděděno od XContainer)
Add(Object[])	Přidá zadaný obsah jako podřízené položky tohoto XContainersouboru . (Zděděno od XContainer)
AddAfterSelf(Object)	Přidá zadaný obsah ihned za tento uzel. (Zděděno od XNode)
AddAfterSelf(Object[])	Přidá zadaný obsah ihned za tento uzel. (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 prvku. (Zděděno od XContainer)
AddFirst(Object[])	Přidá zadaný obsah jako první podřízené položky tohoto dokumentu nebo prvku. (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. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName hodnoty. (Zděděno od XNode)
AncestorsAndSelf()	Vrátí kolekci prvků, které obsahují tento prvek, a předky tohoto prvku.
AncestorsAndSelf(XName)	Vrátí filtrovanou kolekci prvků, které obsahují tento prvek, a předky tohoto prvku. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName hodnoty.
Annotation(Type)	Získá první objekt poznámky zadaného typu z tohoto XObject. (Zděděno od XObject)
Annotation<T>()	Získá první objekt poznámky 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)	Vrátí hodnotu XAttribute , XElement která má zadanou XNamehodnotu .
Attributes()	Vrátí kolekci atributů tohoto prvku.
Attributes(XName)	Vrátí filtrovanou kolekci atributů tohoto prvku. Do kolekce jsou zahrnuty pouze atributy, které mají odpovídající XName hodnotu.
CreateReader()	Vytvoří pro XmlReader tento uzel objekt . (Zděděno od XNode)
CreateReader(ReaderOptions)	Vytvoří s XmlReader možnostmi určenými parametrem readerOptions . (Zděděno od XNode)
CreateWriter()	Vytvoří objekt XmlWriter , který lze použít k přidání uzlů do objektu XContainer. (Zděděno od XContainer)
DescendantNodes()	Vrátí kolekci následnických uzlů pro tento dokument nebo prvek v pořadí dokumentů. (Zděděno od XContainer)
DescendantNodesAndSelf()	Vrátí kolekci uzlů, které obsahují tento prvek a všechny podřízené uzly tohoto prvku v pořadí dokumentů.
Descendants()	Vrátí kolekci následnických elementů pro tento dokument nebo prvek v pořadí dokumentů. (Zděděno od XContainer)
Descendants(XName)	Vrátí filtrovanou kolekci následnických prvků pro tento dokument nebo prvek v pořadí dokumentů. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName hodnoty. (Zděděno od XContainer)
DescendantsAndSelf()	Vrátí kolekci prvků, které obsahují tento prvek a všechny odvozené prvky tohoto prvku v pořadí dokumentu.
DescendantsAndSelf(XName)	Vrátí filtrovanou kolekci prvků, které obsahují tento prvek a všechny následné prvky tohoto prvku v pořadí dokumentů. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName hodnoty.
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í dokumentů. (Zděděno od XContainer)
Elements(XName)	Vrátí filtrovanou kolekci podřízených prvků tohoto prvku nebo dokumentu v pořadí dokumentů. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName hodnoty. (Zděděno od XContainer)
ElementsAfterSelf()	Vrátí kolekci prvků na stejné úrovni za tímto uzlem v pořadí dokumentů. (Zděděno od XNode)
ElementsAfterSelf(XName)	Vrátí filtrovanou kolekci prvků na stejné úrovni za tímto uzlem v pořadí dokumentů. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName hodnoty. (Zděděno od XNode)
ElementsBeforeSelf()	Vrátí kolekci prvků na stejné úrovni před tímto uzlem v pořadí dokumentů. (Zděděno od XNode)
ElementsBeforeSelf(XName)	Vrátí filtrovanou kolekci prvků na stejné úrovni před tímto uzlem v pořadí dokumentů. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName hodnoty. (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 XElementobjektu .
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetNamespaceOfPrefix(String)	Získá obor názvů přidružený ke konkrétní 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á z aktuální instance. (Zděděno od Object)
IsAfter(XNode)	Určuje, zda se aktuální uzel zobrazí za zadaným uzlem z hlediska pořadí dokumentů. (Zděděno od XNode)
IsBefore(XNode)	Určuje, zda se aktuální uzel zobrazuje 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, volitelně zachová prázdné znaky, nastaví základní identifikátor URI a zachová informace o řádku.
Load(String)	Načte ze souboru objekt XElement .
Load(String, LoadOptions)	Načte objekt XElement ze souboru, volitelně zachová prázdné znaky, nastaví základní identifikátor URI a zachová informace o řádku.
Load(TextReader)	Načte objekt XElement z objektu TextReader.
Load(TextReader, LoadOptions)	XElement Načte z objektu TextReader, volitelně zachová prázdné znaky a zachová informace o řádce.
Load(XmlReader)	Načte objekt XElement z objektu XmlReader.
Load(XmlReader, LoadOptions)	XElement Načte z objektu XmlReader, volitelně zachová prázdné znaky, nastaví základní identifikátor URI a zachová informace o řádku.
LoadAsync(Stream, LoadOptions, CancellationToken)	Asynchronně vytvoří nový XElement a inicializuje svůj základní strom XML pomocí zadaného streamu, volitelně zachová prázdné znaky.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Asynchronně vytvoří nový XElement a inicializuje jeho základní strom XML pomocí zadané čtečky textu, volitelně zachová prázdné znaky.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Asynchronně vytvoří nový XElement a inicializuje svůj základní strom XML pomocí zadané čtečky XML, volitelně zachová prázdné znaky.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (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í dokumentů. (Zděděno od XNode)
NodesBeforeSelf()	Vrátí kolekci uzlů na stejné úrovni před tímto uzlem v pořadí dokumentů. (Zděděno od XNode)
Parse(String)	Načtěte z XElement řetězce, který obsahuje XML.
Parse(String, LoadOptions)	Načtěte z XElement řetězce, který obsahuje XML, volitelně zachová prázdné znaky a zachová informace o řádce.
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 poznámky zadaného typu z tohoto XObject. (Zděděno od XObject)
RemoveAnnotations<T>()	Odebere poznámky zadaného typu z tohoto XObject. (Zděděno od XObject)
RemoveAttributes()	Odebere atributy tohoto XElementobjektu .
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)	Vypíše tuto XElement hodnotu do zadaného Streamparametru .
Save(Stream, SaveOptions)	Vypíše tuto XElement hodnotu do zadaného Streamobjektu , který volitelně určuje chování formátování.
Save(String)	Serializovat tento prvek do souboru.
Save(String, SaveOptions)	Serializovat tento prvek do souboru, volitelně zakázat formátování.
Save(TextWriter)	Serializovat tento prvek na TextWriter.
Save(TextWriter, SaveOptions)	Serializovat tento prvek na TextWriter, volitelně zakázat formátování.
Save(XmlWriter)	Serializovat tento prvek na .XmlWriter
SaveAsync(Stream, SaveOptions, CancellationToken)	Asynchronně to XElement vypíše do objektu Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Asynchronně to XElement vypíše do objektu TextWriter.
SaveAsync(XmlWriter, CancellationToken)	Asynchronně to XElement vypíše do objektu XmlWriter.
SetAttributeValue(XName, Object)	Nastaví hodnotu atributu, přidá atribut nebo atribut odebere.
SetElementValue(XName, Object)	Nastaví hodnotu podřízeného prvku, 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í kód XML pro tento uzel a volitelně zakáže formátování. (Zděděno od XNode)
WriteTo(XmlWriter)	Zapište tento prvek do objektu XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Asynchronně to XElement zapisuje do zadaného zapisovače.

Operátory

Explicit(XElement to Boolean)	Přetypujte hodnotu na XElementBoolean.
Explicit(XElement to DateTime)	Přetypujte hodnotu na XElementDateTime.
Explicit(XElement to DateTimeOffset)	Přetypujte hodnotu na XAttributeDateTimeOffset.
Explicit(XElement to Decimal)	Přetypujte hodnotu na XElementDecimal.
Explicit(XElement to Double)	Přetypujte hodnotu na XElementDouble.
Explicit(XElement to Guid)	Přetypujte hodnotu na XElementGuid.
Explicit(XElement to Int32)	Přetypujte hodnotu na XElementInt32.
Explicit(XElement to Int64)	Přetypujte hodnotu na XElementInt64.
Explicit(XElement to Nullable<Boolean>)	Přetypujte hodnotu na XElementNullable<T> hodnotu Boolean.
Explicit(XElement to Nullable<DateTime>)	Přetypujte hodnotu na XElementNullable<T> hodnotu DateTime.
Explicit(XElement to Nullable<DateTimeOffset>)	Přetypujte hodnotu na XElementNullable<T> hodnotu DateTimeOffset.
Explicit(XElement to Nullable<Decimal>)	Přetypujte hodnotu na XElementNullable<T> hodnotu Decimal.
Explicit(XElement to Nullable<Double>)	Přetypujte hodnotu na XElementNullable<T> hodnotu Double.
Explicit(XElement to Nullable<Guid>)	Přetypujte hodnotu na XElementNullable<T> hodnotu Guid.
Explicit(XElement to Nullable<Int32>)	Přetypujte hodnotu na XElementNullable<T> hodnotu Int32.
Explicit(XElement to Nullable<Int64>)	Přetypujte hodnotu na XElementNullable<T> hodnotu Int64.
Explicit(XElement to Nullable<Single>)	Přetypujte hodnotu na XElementNullable<T> hodnotu Single.
Explicit(XElement to Nullable<TimeSpan>)	Přetypujte hodnotu na XElementNullable<T> hodnotu TimeSpan.
Explicit(XElement to Nullable<UInt32>)	Přetypujte hodnotu na XElementNullable<T> hodnotu UInt32.
Explicit(XElement to Nullable<UInt64>)	Přetypujte hodnotu na XElementNullable<T> hodnotu UInt64.
Explicit(XElement to Single)	Přetypujte hodnotu na XElementSingle.
Explicit(XElement to String)	Přetypujte hodnotu na XElementString.
Explicit(XElement to TimeSpan)	Přetypujte hodnotu na XElementTimeSpan.
Explicit(XElement to UInt32)	Přetypujte hodnotu na XElementUInt32.
Explicit(XElement to UInt64)	Přetypujte hodnotu na XElementUInt64.

Událost

Changed	Vyvolána, když se změní tento XObject nebo kterýkoli z jeho potomků. (Zděděno od XObject)
Changing	Vyvolána, když se tento XObject nebo kterýkoli z jeho potomků změní. (Zděděno od XObject)

Explicitní implementace rozhraní

IXmlLineInfo.HasLineInfo()	Získá hodnotu označující, zda má XObject nebo nemá informace o řádku. (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 řádku, že podkladové 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 jeho reprezentace XML.
IXmlSerializable.WriteXml(XmlWriter)	Převede objekt do jeho reprezentace XML.

Metody rozšíření

GetSchemaInfo(XElement)	Získá post-schema-validation infoset (PSVI) ověřeného elementu.
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)	Tato metoda ověří, že XElement pod strom vyhovuje zadanému XmlSchemaObject objektu XmlSchemaSeta .
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)	Ověří, jestli XElement pod strom vyhovuje zadanému XmlSchemaObject objektu XmlSchemaSeta , volitelně naplní strom XML sadou psvi (post-schema-validation infoset).
CreateNavigator(XNode)	Vytvoří pro XPathNavigatorXNodeobjekt .
CreateNavigator(XNode, XmlNameTable)	Vytvoří pro XPathNavigatorXNodeobjekt . 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 IXmlNamespaceResolver.
XPathSelectElement(XNode, String)	Vybere XElement pomocí výrazu XPath.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	XElement Vybere pomocí výrazu XPath a přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolver.
XPathSelectElements(XNode, String)	Vybere kolekci elementů pomocí výrazu XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Vybere kolekci elementů pomocí výrazu XPath a přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolver.
ToXPathNavigable(XNode)	Vrátí přístup, který umožňuje navigaci a úpravu zadaného XNodeobjektu .

Viz také

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