XElement Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje element XML. Informace o využití a příklady najdete na této stránce v části Přehled tříd XElement a poznámky.
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
- Implementuje
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říd XElement .
Prvek má XNamevolitelně jeden nebo více atributů a může volitelně obsahovat obsah (další informace viz Nodes).
Může XElement obsahovat následující typy obsahu:
Podrobnosti o platném obsahu objektu XElement, naleznete v části Platný obsah XElement a XDocument Objects.
XElement je odvozen od XContainer, který je odvozen od XNode.
Některé XElement metody je možné použít z XAML. Další informace naleznete v tématu LINQ to XML Dynamic Properties.
Konstruktory
| Name | Description |
|---|---|
| XElement(XElement) |
Inicializuje novou instanci XElement třídy z jiného XElement objektu. |
| 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(XName) |
Inicializuje novou instanci XElement třídy se zadaným názvem. |
| XElement(XStreamingElement) |
Inicializuje novou instanci XElement třídy z objektu XStreamingElement . |
Vlastnosti
| Name | Description |
|---|---|
| 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 tohoto 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
| Name | Description |
|---|---|
| Add(Object) |
Přidá zadaný obsah jako podřízené položky XContainertohoto souboru . (Zděděno od XContainer) |
| Add(Object[]) |
Přidá zadaný obsah jako podřízené položky XContainertohoto souboru . (Zděděno od XContainer) |
| AddAfterSelf(Object) |
Přidá zadaný obsah bezprostředně za tímto uzlem. (Zděděno od XNode) |
| AddAfterSelf(Object[]) |
Přidá zadaný obsah bezprostředně 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. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající 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é obsahují tento prvek, a nadřazené prvky tohoto prvku. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající 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í odpovídající hodnoty XName . |
| CreateReader() |
Vytvoří pro tento uzel.XmlReader (Zděděno od XNode) |
| CreateReader(ReaderOptions) |
Vytvoří s XmlReader možnostmi zadanými parametrem |
| 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 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í dokumentu. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající 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é obsahují tento prvek, a všechny následné prvky tohoto prvku v pořadí dokumentu. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName. |
| Element(XName) |
Získá první (v pořadí dokumentu) 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. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName. (Zděděno od XContainer) |
| ElementsAfterSelf() |
Vrátí kolekci prvků na stejné úrovni za tímto uzlem v pořadí dokumentu. (Zděděno od XNode) |
| ElementsAfterSelf(XName) |
Vrátí filtrovanou kolekci prvků na stejné úrovni za tímto uzlem v pořadí dokumentu. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName. (Zděděno od XNode) |
| ElementsBeforeSelf() |
Vrátí kolekci prvků na stejné úrovni před tímto uzlem v pořadí dokumentu. (Zděděno od XNode) |
| ElementsBeforeSelf(XName) |
Vrátí filtrovanou kolekci prvků na stejné úrovni před tímto uzlem v pořadí dokumentu. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName. (Zděděno od XNode) |
| Equals(Object) |
Určuje, zda je zadaný objekt roven 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ý 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() |
Získá Type aktuální instance. (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, 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(Stream) |
Vytvoří novou XElement instanci pomocí zadaného datového proudu. |
| Load(String, LoadOptions) |
Načte ze XElement souboru, volitelně zachová prázdné znaky, nastaví základní identifikátor URI a zachová informace o řádku. |
| Load(String) |
Načte soubor XElement ze souboru. |
| Load(TextReader, LoadOptions) |
Načte z XElement objektu TextReader, volitelně zachová prázdné znaky a zachová informace o čárách. |
| Load(TextReader) |
Načte z XElement objektu TextReader. |
| Load(XmlReader, LoadOptions) |
XElement Načte z volitelného XmlReaderzachování prázdných znaků, nastavení základního identifikátoru URI a zachování informací o řádku. |
| Load(XmlReader) | |
| LoadAsync(Stream, LoadOptions, CancellationToken) |
Asynchronně vytvoří nový XElement a inicializuje jeho základní strom XML pomocí zadaného datového proudu, volitelně zachová prázdné znaky. |
| LoadAsync(TextReader, LoadOptions, CancellationToken) |
Asynchronně vytvoří nový XElement a inicializuje základní strom XML pomocí zadané čtečky textu, volitelně zachová prázdné znaky. |
| LoadAsync(XmlReader, LoadOptions, CancellationToken) |
Asynchronně vytvoří novou XElement a inicializuje její základní strom XML pomocí zadané čtečky XML, volitelně zachová prázdné znaky. |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| Nodes() |
Vrátí kolekci podřízených uzlů tohoto prvku nebo dokumentu v pořadí dokumentu. (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, LoadOptions) |
XElement Načtěte z řetězce, který obsahuje XML, volitelně zachová prázdné znaky a zachová řádkové informace. |
| Parse(String) |
Načtěte z XElement řetězce, který obsahuje XML. |
| 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 XElement. |
| RemoveNodes() |
Odebere podřízené uzly z tohoto dokumentu nebo prvku. (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, SaveOptions) |
Výstupem je XElement zadané Stream, volitelně určení chování formátování. |
| Save(Stream) | |
| Save(String, SaveOptions) |
Serializovat tento prvek do souboru, volitelně zakázání formátování. |
| Save(String) |
Serializovat tento prvek do souboru. |
| Save(TextWriter, SaveOptions) |
Serializovat tento prvek na TextWriter, volitelně zakázání formátování. |
| Save(TextWriter) |
Serializovat tento prvek na .TextWriter |
| Save(XmlWriter) |
Serializace tohoto prvku na .XmlWriter |
| SaveAsync(Stream, SaveOptions, CancellationToken) | |
| SaveAsync(TextWriter, SaveOptions, CancellationToken) |
Asynchronně to XElement vypíše na .TextWriter |
| SaveAsync(XmlWriter, CancellationToken) | |
| 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í kód XML pro tento uzel a volitelně zakáže 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. |
Operátory
Událost
| Name | Description |
|---|---|
| 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 tento XObject nebo kterýkoli z jejích potomků chystá změnit. (Zděděno od XObject) |
Explicitní implementace rozhraní
| Name | Description |
|---|---|
| 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 toto XObject. (Zděděno od XObject) |
| IXmlLineInfo.LinePosition |
Získá pozici čáry, kterou základní hlášeno XmlReader pro toto XObject. (Zděděno od XObject) |
| IXmlSerializable.GetSchema() |
Získá definici schématu XML, která popisuje reprezentaci XML tohoto objektu. |
| IXmlSerializable.ReadXml(XmlReader) |
Vygeneruje objekt z jeho reprezentace XML. |
| IXmlSerializable.WriteXml(XmlWriter) |
Převede objekt na jeho reprezentaci XML. |
Metody rozšíření
| Name | Description |
|---|---|
| CreateNavigator(XNode, XmlNameTable) |
Vytvoří pro XPathNavigator objekt XNode. Umožňuje XmlNameTable efektivnější zpracování výrazů XPath. |
| CreateNavigator(XNode) |
Vytvoří pro XPathNavigator objekt XNode. |
| GetSchemaInfo(XElement) |
Získá post-schema-validation infoset (PSVI) ověřeného elementu. |
| ToXPathNavigable(XNode) |
Vrátí přístupový objekt, který umožňuje procházet a upravovat zadané XNodeobjekty . |
| Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean) |
Ověří, že XElement dílčí strom odpovídá zadanému XmlSchemaObject a volitelnému XmlSchemaSetnaplnění stromu XML sadou informací po ověření schématu (PSVI). |
| Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler) |
Tato metoda ověří, že XElement dílčí strom odpovídá zadanému XmlSchemaObject a určitému XmlSchemaSetstromu . |
| XPathEvaluate(XNode, String, IXmlNamespaceResolver) |
Vyhodnotí výraz XPath a přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolvervýrazu . |
| XPathEvaluate(XNode, String) |
Vyhodnotí výraz XPath. |
| XPathSelectElement(XNode, String, IXmlNamespaceResolver) |
Vybere výraz XElement XPath, přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolvervýrazu . |
| XPathSelectElement(XNode, String) |
Vybere XElement výraz XPath. |
| XPathSelectElements(XNode, String, IXmlNamespaceResolver) |
Vybere kolekci prvků pomocí výrazu XPath, přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolvervýrazu . |
| XPathSelectElements(XNode, String) |
Vybere kolekci prvků pomocí výrazu XPath. |