XElement Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
XML-elemet jelöl. A használattal kapcsolatos információkért és példákért tekintse meg az XElement-osztály áttekintését és a megjegyzések szakaszt ezen a lapon.
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
- Öröklődés
- Megvalósítás
Példák
Az alábbi példa létrehoz egy XML-fát. Az új elem tartalma egy LINQ-lekérdezésből származik.
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)
Ez a példa a következő kimenetet hozza létre:
<Root>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
A következő példa ugyanaz, de ebben az esetben az XML névtérben van. További információ: XML-névterek használata.
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
Ez a példa a következő kimenetet hozza létre:
<Root xmlns="http://www.adventure-works.com">
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
Megjegyzések
Ez az osztály egy XML-elemet, az alapvető XML-szerkezetet jelöli. További használati információkért tekintse meg az XElement-osztály áttekintését .
Egy elem rendelkezik egy XName, opcionálisan egy vagy több attribútummal, és opcionálisan tartalmazhat tartalmakat (további információ: Nodes).
Egy XElement tartalomtípus a következő típusú tartalmakat tartalmazhatja:
Az egyes XElementobjektumok érvényes tartalmával kapcsolatos részletekért lásd az XElement és az XDocument Objektumok érvényes tartalmát.
XElement származik XContainer, amely származik XNode.
Egyes XElement módszerek az XAML-ből is használhatók. További információ: LINQ–XML dinamikus tulajdonságok.
Konstruktorok
| Name | Description |
|---|---|
| XElement(XElement) |
Inicializálja az osztály új példányát XElement egy másik XElement objektumból. |
| XElement(XName, Object) |
Inicializálja az XElement osztály új példányát a megadott névvel és tartalommal. |
| XElement(XName, Object[]) |
Inicializálja az XElement osztály új példányát a megadott névvel és tartalommal. |
| XElement(XName) |
Inicializálja az XElement osztály új példányát a megadott névvel. |
| XElement(XStreamingElement) |
Inicializálja az XElement osztály új példányát egy XStreamingElement objektumból. |
Tulajdonságok
| Name | Description |
|---|---|
| BaseUri |
Lekéri ehhez az alap URI-t XObject. (Öröklődés forrása XObject) |
| Document |
Megkapja ezt XDocumenta XObject . (Öröklődés forrása XObject) |
| EmptySequence |
Üres elemgyűjteményt kap. |
| FirstAttribute |
Lekéri az elem első attribútumát. |
| FirstNode |
Lekéri a csomópont első gyermekcsomópontját. (Öröklődés forrása XContainer) |
| HasAttributes |
Beolvas egy értéket, amely jelzi, hogy az elem rendelkezik-e legalább egy attribútummal. |
| HasElements |
Beolvas egy értéket, amely jelzi, hogy az elem rendelkezik-e legalább egy gyermekelemmel. |
| IsEmpty |
Beolvas egy értéket, amely jelzi, hogy az elem nem tartalmaz-e tartalmat. |
| LastAttribute |
Lekéri az elem utolsó attribútumát. |
| LastNode |
Lekéri a csomópont utolsó gyermekcsomópontját. (Öröklődés forrása XContainer) |
| Name |
Lekéri vagy beállítja ennek az elemnek a nevét. |
| NextNode |
Lekéri a csomópont következő testvércsomópontját. (Öröklődés forrása XNode) |
| NodeType |
Lekéri a csomópont csomóponttípusát. |
| Parent |
Lekéri ennek XElementa szülőjének a szülőjeXObject. (Öröklődés forrása XObject) |
| PreviousNode |
Lekéri a csomópont előző testvércsomópontját. (Öröklődés forrása XNode) |
| Value |
Lekéri vagy beállítja az elem összefűzött szöveges tartalmát. |
Metódusok
| Name | Description |
|---|---|
| Add(Object) |
Hozzáadja a megadott tartalmat ennek a XContainergyermekként. (Öröklődés forrása XContainer) |
| Add(Object[]) |
Hozzáadja a megadott tartalmat ennek a XContainergyermekként. (Öröklődés forrása XContainer) |
| AddAfterSelf(Object) |
A megadott tartalmat közvetlenül a csomópont után adja hozzá. (Öröklődés forrása XNode) |
| AddAfterSelf(Object[]) |
A megadott tartalmat közvetlenül a csomópont után adja hozzá. (Öröklődés forrása XNode) |
| AddAnnotation(Object) |
Objektumot ad hozzá a jegyzetlistához.XObject (Öröklődés forrása XObject) |
| AddBeforeSelf(Object) |
Közvetlenül a csomópont előtt adja hozzá a megadott tartalmat. (Öröklődés forrása XNode) |
| AddBeforeSelf(Object[]) |
Közvetlenül a csomópont előtt adja hozzá a megadott tartalmat. (Öröklődés forrása XNode) |
| AddFirst(Object) |
A dokumentum vagy elem első gyermekeként adja hozzá a megadott tartalmat. (Öröklődés forrása XContainer) |
| AddFirst(Object[]) |
A dokumentum vagy elem első gyermekeként adja hozzá a megadott tartalmat. (Öröklődés forrása XContainer) |
| Ancestors() |
A csomópont elődelemeinek gyűjteményét adja vissza. (Öröklődés forrása XNode) |
| Ancestors(XName) |
A csomópont őselemeinek szűrt gyűjteményét adja vissza. A gyűjtemény csak az egyező XName elemeket tartalmazza. (Öröklődés forrása XNode) |
| AncestorsAndSelf() |
Az elemet tartalmazó elemek gyűjteményét és az elem elődeit adja vissza. |
| AncestorsAndSelf(XName) |
Az elemet tartalmazó elemek szűrt gyűjteményét adja vissza, valamint az elem elődeit. A gyűjtemény csak az egyező XName elemeket tartalmazza. |
| Annotation(Type) |
A megadott típus első széljegyzetobjektumának lekérdezése ebből XObjecta helyről. (Öröklődés forrása XObject) |
| Annotation<T>() |
A megadott típus első széljegyzetobjektumának lekérdezése ebből XObjecta helyről. (Öröklődés forrása XObject) |
| Annotations(Type) |
Lekéri a megadott típusú széljegyzetek gyűjteményét.XObject (Öröklődés forrása XObject) |
| Annotations<T>() |
Lekéri a megadott típusú széljegyzetek gyűjteményét.XObject (Öröklődés forrása XObject) |
| Attribute(XName) |
XAttribute XElement A megadott XNameértéket adja vissza. |
| Attributes() |
Ennek az elemnek az attribútumgyűjteményét adja vissza. |
| Attributes(XName) |
Az elem attribútumainak szűrt gyűjteményét adja vissza. Csak az egyező XName attribútumok szerepelnek a gyűjteményben. |
| CreateReader() |
Létrehoz egy csomópontot XmlReader . (Öröklődés forrása XNode) |
| CreateReader(ReaderOptions) |
Létrehoz egy, XmlReader a paraméter által |
| CreateWriter() |
Létrehoz egy olyan csomópontot XmlWriter , amellyel csomópontokat adhat hozzá a XContainer. (Öröklődés forrása XContainer) |
| DescendantNodes() |
A dokumentum vagy elem leszármazott csomópontjainak gyűjteményét adja vissza dokumentumsorrendben. (Öröklődés forrása XContainer) |
| DescendantNodesAndSelf() |
Az elemet tartalmazó csomópontok gyűjteményét adja vissza, valamint az elem összes leszármazó csomópontját dokumentumsorrendben. |
| Descendants() |
A dokumentum vagy elem leszármazott elemeinek gyűjteményét adja vissza dokumentumsorrendben. (Öröklődés forrása XContainer) |
| Descendants(XName) |
A dokumentum vagy elem leszármazott elemeinek szűrt gyűjteményét adja vissza dokumentumsorrendben. A gyűjtemény csak az egyező XName elemeket tartalmazza. (Öröklődés forrása XContainer) |
| DescendantsAndSelf() |
Az elemet tartalmazó elemek gyűjteményét, valamint az elem összes leszármazott elemét adja vissza dokumentumsorrendben. |
| DescendantsAndSelf(XName) |
Az elemek szűrt gyűjteményét adja vissza, amely tartalmazza ezt az elemet, valamint az elem összes leszármazott elemét dokumentumsorrendben. A gyűjtemény csak az egyező XName elemeket tartalmazza. |
| Element(XName) |
Lekéri az első (dokumentum szerinti) gyermekelemet a megadott XName. (Öröklődés forrása XContainer) |
| Elements() |
Az elem vagy dokumentum gyermekelemeinek gyűjteményét adja vissza dokumentumsorrendben. (Öröklődés forrása XContainer) |
| Elements(XName) |
Az elem vagy dokumentum gyermekelemeinek szűrt gyűjteményét adja vissza dokumentumsorrendben. A gyűjtemény csak az egyező XName elemeket tartalmazza. (Öröklődés forrása XContainer) |
| ElementsAfterSelf() |
A csomópont utáni testvérelemek gyűjteményét adja vissza dokumentumsorrendben. (Öröklődés forrása XNode) |
| ElementsAfterSelf(XName) |
A csomópont után a testvérelemek szűrt gyűjteményét adja vissza dokumentumsorrendben. A gyűjtemény csak az egyező XName elemeket tartalmazza. (Öröklődés forrása XNode) |
| ElementsBeforeSelf() |
A csomópont előtti testvérelemek gyűjteményét adja vissza dokumentumsorrendben. (Öröklődés forrása XNode) |
| ElementsBeforeSelf(XName) |
A csomópont előtti testvérelemek szűrt gyűjteményét adja vissza dokumentumsorrendben. A gyűjtemény csak az egyező XName elemeket tartalmazza. (Öröklődés forrása XNode) |
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| GetDefaultNamespace() |
Ennek az alapértelmezett XNamespace értéknek a lekérése XElement. |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetNamespaceOfPrefix(String) |
Lekéri az adott előtaghoz társított névteret.XElement |
| GetPrefixOfNamespace(XNamespace) |
Lekéri a névtérhez társított előtagot.XElement |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| IsAfter(XNode) |
Meghatározza, hogy az aktuális csomópont egy adott csomópont után jelenik-e meg a dokumentumrend szempontjából. (Öröklődés forrása XNode) |
| IsBefore(XNode) |
Meghatározza, hogy az aktuális csomópont megjelenik-e egy adott csomópont előtt a dokumentumrend szempontjából. (Öröklődés forrása XNode) |
| Load(Stream, LoadOptions) |
Létrehoz egy új XElement példányt a megadott stream használatával, opcionálisan megőrizve a szabad területet, beállítja az alap URI-t, és megőrzi a sorinformációkat. |
| Load(Stream) |
Új példányt XElement hoz létre a megadott stream használatával. |
| Load(String, LoadOptions) |
Betölt egy XElement fájlt, opcionálisan megőrzi a szabad területet, beállítja az alap URI-t, és megtartja a sorinformációkat. |
| Load(String) |
Betölt egy XElement fájlt. |
| Load(TextReader, LoadOptions) |
Betölt egy üres XElementTextReaderhelyet, és megtartja a vonalinformációkat. |
| Load(TextReader) |
Betölt egy XElement elemet egy TextReaderhelyről. |
| Load(XmlReader, LoadOptions) |
Betölt egy XElementXmlReader, opcionálisan megtartott üres területből, beállítja az alap URI-t, és megtartja a sorinformációkat. |
| Load(XmlReader) | |
| LoadAsync(Stream, LoadOptions, CancellationToken) |
Aszinkron módon létrehoz egy újat XElement , és inicializálja a mögöttes XML-fát a megadott stream használatával, opcionálisan megőrizve a szabad területet. |
| LoadAsync(TextReader, LoadOptions, CancellationToken) |
Aszinkron módon létrehoz egy újat XElement , és inicializálja a mögöttes XML-fát a megadott szövegolvasó használatával, opcionálisan megőrizve a szabad területet. |
| LoadAsync(XmlReader, LoadOptions, CancellationToken) |
Aszinkron módon létrehoz egy újat XElement , és inicializálja a mögöttes XML-fát a megadott XML-olvasó használatával, opcionálisan megőrizve a szabad területet. |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| Nodes() |
Az elem vagy dokumentum gyermekcsomópontjainak gyűjteményét adja vissza dokumentumsorrendben. (Öröklődés forrása XContainer) |
| NodesAfterSelf() |
A testvércsomópontok gyűjteményét adja vissza a csomópont után, dokumentumsorrendben. (Öröklődés forrása XNode) |
| NodesBeforeSelf() |
A csomópont előtti testvércsomópontok gyűjteményét adja vissza dokumentumsorrendben. (Öröklődés forrása XNode) |
| Parse(String, LoadOptions) |
Töltsön be egy XElement XML-t tartalmazó sztringet, amely opcionálisan megőrzi a szabad területet és megőrzi a sorinformációkat. |
| Parse(String) |
Töltsön be egy XElement XML-t tartalmazó sztringet. |
| Remove() |
Eltávolítja ezt a csomópontot a szülőből. (Öröklődés forrása XNode) |
| RemoveAll() |
Eltávolítja a csomópontokat és attribútumokat ebből a helyről XElement. |
| RemoveAnnotations(Type) |
Eltávolítja a megadott típusú széljegyzeteket ebből a XObjecthelyről. (Öröklődés forrása XObject) |
| RemoveAnnotations<T>() |
Eltávolítja a megadott típusú széljegyzeteket ebből a XObjecthelyről. (Öröklődés forrása XObject) |
| RemoveAttributes() |
Eltávolítja ennek az attribútumnak az attribútumait XElement. |
| RemoveNodes() |
Eltávolítja a gyermekcsomópontokat ebből a dokumentumból vagy elemből. (Öröklődés forrása XContainer) |
| ReplaceAll(Object) |
Lecseréli a gyermekcsomópontokat és az elem attribútumait a megadott tartalomra. |
| ReplaceAll(Object[]) |
Lecseréli a gyermekcsomópontokat és az elem attribútumait a megadott tartalomra. |
| ReplaceAttributes(Object) |
Az elem attribútumait lecseréli a megadott tartalomra. |
| ReplaceAttributes(Object[]) |
Az elem attribútumait lecseréli a megadott tartalomra. |
| ReplaceNodes(Object) |
A dokumentum vagy elem gyermekcsomópontjait lecseréli a megadott tartalomra. (Öröklődés forrása XContainer) |
| ReplaceNodes(Object[]) |
A dokumentum vagy elem gyermekcsomópontjait lecseréli a megadott tartalomra. (Öröklődés forrása XContainer) |
| ReplaceWith(Object) |
Ezt a csomópontot lecseréli a megadott tartalomra. (Öröklődés forrása XNode) |
| ReplaceWith(Object[]) |
Ezt a csomópontot lecseréli a megadott tartalomra. (Öröklődés forrása XNode) |
| Save(Stream, SaveOptions) |
Ezt XElement a megadott Stream, opcionálisan a formázási viselkedést megadva adja meg. |
| Save(Stream) | |
| Save(String, SaveOptions) |
Szerializálja ezt az elemet egy fájlba, opcionálisan letiltva a formázást. |
| Save(String) |
Szerializálja ezt az elemet egy fájlba. |
| Save(TextWriter, SaveOptions) |
Szerializálja ezt az elemet egy TextWriter, opcionálisan letiltó formázásra. |
| Save(TextWriter) |
Szerializálja ezt az elemet egy TextWriter. |
| Save(XmlWriter) |
Szerializálja ezt az elemet egy XmlWriter. |
| SaveAsync(Stream, SaveOptions, CancellationToken) | |
| SaveAsync(TextWriter, SaveOptions, CancellationToken) |
Aszinkron módon egy XElementTextWriter. |
| SaveAsync(XmlWriter, CancellationToken) | |
| SetAttributeValue(XName, Object) |
Beállítja egy attribútum értékét, hozzáad egy attribútumot, vagy eltávolít egy attribútumot. |
| SetElementValue(XName, Object) |
Beállítja egy gyermekelem értékét, hozzáad egy gyermekelemet, vagy eltávolít egy gyermekelemet. |
| SetValue(Object) |
Az elem értékét állítja be. |
| ToString() |
A csomópont behúzásos XML-értékét adja vissza. (Öröklődés forrása XNode) |
| ToString(SaveOptions) |
Ennek a csomópontnak az XML-ét adja vissza, opcionálisan letiltva a formázást. (Öröklődés forrása XNode) |
| WriteTo(XmlWriter) |
Írja ezt az elemet egy XmlWriter. |
| WriteToAsync(XmlWriter, CancellationToken) |
Aszinkron módon írja ezt XElement a megadott írónak. |
Operátorok
esemény
| Name | Description |
|---|---|
| Changed |
Akkor merül fel, amikor ez XObject vagy bármelyik leszármazottja megváltozott. (Öröklődés forrása XObject) |
| Changing |
Akkor merül fel, amikor ez XObject vagy bármelyik leszármazottja megváltozik. (Öröklődés forrása XObject) |
Explicit interfész-implementációk
| Name | Description |
|---|---|
| IXmlLineInfo.HasLineInfo() |
Beolvas egy értéket, amely jelzi, hogy ez XObject tartalmaz-e sorinformációkat. (Öröklődés forrása XObject) |
| IXmlLineInfo.LineNumber |
Lekéri a mögöttes jelentéshez XmlReader tartozó sorszámot.XObject (Öröklődés forrása XObject) |
| IXmlLineInfo.LinePosition |
Lekéri a mögöttes jelentéshez XmlReader tartozó vonalpozíciót XObject. (Öröklődés forrása XObject) |
| IXmlSerializable.GetSchema() |
Lekéri az objektum XML-ábrázolását leíró XML-sémadefiníciót. |
| IXmlSerializable.ReadXml(XmlReader) |
Létrehoz egy objektumot az XML-reprezentációjából. |
| IXmlSerializable.WriteXml(XmlWriter) |
Átalakítja az objektumot XML-reprezentációvá. |
Bővítő metódusok
| Name | Description |
|---|---|
| CreateNavigator(XNode, XmlNameTable) |
Létrehoz egy XPathNavigatorXNode. Ez XmlNameTable hatékonyabb XPath-kifejezésfeldolgozást tesz lehetővé. |
| CreateNavigator(XNode) |
Létrehoz egy XPathNavigatorXNode. |
| GetSchemaInfo(XElement) |
Lekéri egy érvényesített elem séma utáni érvényesítési adatkészletét (PSVI). |
| ToXPathNavigable(XNode) |
Egy olyan tartozékot ad vissza, amely lehetővé teszi a megadott XNodeelem navigálását és szerkesztését. |
| Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean) |
Ellenőrzi, hogy egy XElement alfa megfelel-e egy megadott XmlSchemaObject és egy XmlSchemaSet, opcionálisan az XML-fa feltöltésének a séma utáni érvényesítési információs adatkészlettel (PSVI). |
| Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler) |
Ez a metódus ellenőrzi, hogy egy XElement alfa megfelel-e egy megadott XmlSchemaObject és egy XmlSchemaSet. |
| XPathEvaluate(XNode, String, IXmlNamespaceResolver) |
Kiértékel egy XPath-kifejezést, és feloldja a névtér előtagjait a megadott IXmlNamespaceResolverhasználatával. |
| XPathEvaluate(XNode, String) |
Kiértékel egy XPath-kifejezést. |
| XPathSelectElement(XNode, String, IXmlNamespaceResolver) |
Kiválaszt egy XElement XPath-kifejezést, amely feloldja a névtér előtagjait a megadott IXmlNamespaceResolverhasználatával. |
| XPathSelectElement(XNode, String) |
Kiválaszt egy XElement XPath-kifejezést. |
| XPathSelectElements(XNode, String, IXmlNamespaceResolver) |
Kiválaszt egy elemgyűjteményt egy XPath-kifejezéssel, és feloldja a névtér előtagjait a megadott IXmlNamespaceResolverparanccsel. |
| XPathSelectElements(XNode, String) |
Elemek gyűjteményét választja ki egy XPath-kifejezés használatával. |