XElement Klass

Definition

Namnområde:
System.Xml.Linq
Sammansättningar:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Sammansättningar:
netstandard.dll, System.Xml.XDocument.dll
Sammansättning:
System.Xml.XDocument.dll
Sammansättning:
System.Xml.Linq.dll
Sammansättning:
netstandard.dll
Källa:
XElement.cs
Källa:
XElement.cs
Källa:
XElement.cs
Källa:
XElement.cs
Källa:
XElement.cs

Representerar ett XML-element. Se XElement-klassöversikt och avsnittet Kommentarer på den här sidan för användningsinformation och exempel.

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
Arv
Object
XObject
XNode
XContainer
XElement
Implementeringar
IXmlSerializable

Exempel

I följande exempel skapas ett XML-träd. Innehållet i det nya elementet kommer från en LINQ-fråga.

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)

Det här exemplet genererar följande utdata:

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

Följande är samma exempel, men i det här fallet finns XML i ett namnområde. Mer information finns i Arbeta med XML-namnområden.

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

Det här exemplet genererar följande utdata:

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

Kommentarer

Den här klassen representerar ett XML-element, den grundläggande XML-konstruktionen. Se Översikt över XElement-klass för annan användningsinformation.

Ett element har ett XName, om du vill, ett eller flera attribut och kan eventuellt innehålla innehåll (mer information finns i Nodes).

En XElement kan innehålla följande typer av innehåll:

Mer information om det giltiga innehållet i en XElementfinns i Giltigt innehåll för XElement- och XDocument-objekt.

XElement härleds från XContainer, som härleds från XNode.

Vissa XElement metoder kan användas från XAML. Mer information finns i LINQ till XML dynamiska egenskaper.

Konstruktorer

Name Description
XElement(XElement)

Initierar en ny instans av XElement klassen från ett annat XElement objekt.
XElement(XName, Object)

Initierar en ny instans av XElement klassen med det angivna namnet och innehållet.
XElement(XName, Object[])

Initierar en ny instans av XElement klassen med det angivna namnet och innehållet.
XElement(XName)

Initierar en ny instans av XElement klassen med det angivna namnet.
XElement(XStreamingElement)

Initierar en ny instans av XElement klassen från ett XStreamingElement objekt.

Egenskaper

Name Description
BaseUri

Hämtar bas-URI:n för detta XObject.

(Ärvd från XObject)
Document

XDocument Hämtar för detta XObject.

(Ärvd från XObject)
EmptySequence

Hämtar en tom samling element.
FirstAttribute

Hämtar det första attributet för det här elementet.
FirstNode

Hämtar den första underordnade noden för den här noden.

(Ärvd från XContainer)
HasAttributes

Hämtar ett värde som anger om det här elementet har minst ett attribut.
HasElements

Hämtar ett värde som anger om det här elementet har minst ett underordnat element.
IsEmpty

Hämtar ett värde som anger om det här elementet inte innehåller något innehåll.
LastAttribute

Hämtar det sista attributet för det här elementet.
LastNode

Hämtar den sista underordnade noden för den här noden.

(Ärvd från XContainer)
Name

Hämtar eller anger namnet på det här elementet.
NextNode

Hämtar nästa nod på samma nivå för den här noden.

(Ärvd från XNode)
NodeType

Hämtar nodtypen för den här noden.
Parent

Hämtar överordnad XElement för den här XObject.

(Ärvd från XObject)
PreviousNode

Hämtar den tidigare syskonnoden för den här noden.

(Ärvd från XNode)
Value

Hämtar eller anger det sammanfogade textinnehållet i det här elementet.

Metoder

Name Description
Add(Object)

Lägger till det angivna innehållet som underordnade till detta XContainer.

(Ärvd från XContainer)
Add(Object[])

Lägger till det angivna innehållet som underordnade till detta XContainer.

(Ärvd från XContainer)
AddAfterSelf(Object)

Lägger till det angivna innehållet direkt efter den här noden.

(Ärvd från XNode)
AddAfterSelf(Object[])

Lägger till det angivna innehållet direkt efter den här noden.

(Ärvd från XNode)
AddAnnotation(Object)

Lägger till ett objekt i anteckningslistan för den här XObject.

(Ärvd från XObject)
AddBeforeSelf(Object)

Lägger till det angivna innehållet omedelbart före den här noden.

(Ärvd från XNode)
AddBeforeSelf(Object[])

Lägger till det angivna innehållet omedelbart före den här noden.

(Ärvd från XNode)
AddFirst(Object)

Lägger till det angivna innehållet som de första underordnade i det här dokumentet eller elementet.

(Ärvd från XContainer)
AddFirst(Object[])

Lägger till det angivna innehållet som de första underordnade i det här dokumentet eller elementet.

(Ärvd från XContainer)
Ancestors()

Returnerar en samling av de överordnade elementen i den här noden.

(Ärvd från XNode)
Ancestors(XName)

Returnerar en filtrerad samling av de överordnade elementen i den här noden. Endast element som har matchning XName ingår i samlingen.

(Ärvd från XNode)
AncestorsAndSelf()

Returnerar en samling element som innehåller det här elementet och elementets överordnade element.
AncestorsAndSelf(XName)

Returnerar en filtrerad samling element som innehåller det här elementet och elementets överordnade element. Endast element som har matchning XName ingår i samlingen.
Annotation(Type)

Hämtar det första anteckningsobjektet av den angivna typen från den här XObject.

(Ärvd från XObject)
Annotation<T>()

Hämtar det första anteckningsobjektet av den angivna typen från den här XObject.

(Ärvd från XObject)
Annotations(Type)

Hämtar en samling anteckningar av den angivna typen för den här XObject.

(Ärvd från XObject)
Annotations<T>()

Hämtar en samling anteckningar av den angivna typen för den här XObject.

(Ärvd från XObject)
Attribute(XName)

Returnerar det XAttribute för detta XElement som har den angivna XName.
Attributes()

Returnerar en samling attribut för det här elementet.
Attributes(XName)

Returnerar en filtrerad samling attribut för det här elementet. Endast attribut som har matchning XName ingår i samlingen.
CreateReader()

Skapar en XmlReader för den här noden.

(Ärvd från XNode)
CreateReader(ReaderOptions)

Skapar en XmlReader med de alternativ som anges av parametern readerOptions .

(Ärvd från XNode)
CreateWriter()

Skapar en XmlWriter som kan användas för att lägga till noder i XContainer.

(Ärvd från XContainer)
DescendantNodes()

Returnerar en samling underordnade noder för det här dokumentet eller elementet i dokumentordning.

(Ärvd från XContainer)
DescendantNodesAndSelf()

Returnerar en samling noder som innehåller det här elementet och alla underordnade noder i det här elementet i dokumentordning.
Descendants()

Returnerar en samling underordnade element för det här dokumentet eller elementet i dokumentordning.

(Ärvd från XContainer)
Descendants(XName)

Returnerar en filtrerad samling av underordnade element för det här dokumentet eller elementet i dokumentordning. Endast element som har matchning XName ingår i samlingen.

(Ärvd från XContainer)
DescendantsAndSelf()

Returnerar en samling element som innehåller det här elementet och alla underordnade element i det här elementet i dokumentordning.
DescendantsAndSelf(XName)

Returnerar en filtrerad samling element som innehåller det här elementet och alla underordnade element i det här elementet i dokumentordning. Endast element som har matchning XName ingår i samlingen.
Element(XName)

Hämtar det första underordnade elementet (i dokumentordning) med angivet XName.

(Ärvd från XContainer)
Elements()

Returnerar en samling underordnade element i det här elementet eller dokumentet i dokumentordning.

(Ärvd från XContainer)
Elements(XName)

Returnerar en filtrerad samling av de underordnade elementen i det här elementet eller dokumentet i dokumentordning. Endast element som har matchning XName ingår i samlingen.

(Ärvd från XContainer)
ElementsAfterSelf()

Returnerar en samling av syskonelementen efter den här noden i dokumentordning.

(Ärvd från XNode)
ElementsAfterSelf(XName)

Returnerar en filtrerad samling av syskonelementen efter den här noden i dokumentordning. Endast element som har matchning XName ingår i samlingen.

(Ärvd från XNode)
ElementsBeforeSelf()

Returnerar en samling av syskonelementen före den här noden i dokumentordning.

(Ärvd från XNode)
ElementsBeforeSelf(XName)

Returnerar en filtrerad samling av syskonelementen före den här noden i dokumentordning. Endast element som har matchning XName ingår i samlingen.

(Ärvd från XNode)
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetDefaultNamespace()

Hämtar standardvärdet XNamespace för detta XElement.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetNamespaceOfPrefix(String)

Hämtar namnområdet som är associerat med ett visst prefix för detta XElement.
GetPrefixOfNamespace(XNamespace)

Hämtar prefixet som är associerat med ett namnområde för detta XElement.
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
IsAfter(XNode)

Avgör om den aktuella noden visas efter en angiven nod när det gäller dokumentordning.

(Ärvd från XNode)
IsBefore(XNode)

Avgör om den aktuella noden visas före en angiven nod när det gäller dokumentordning.

(Ärvd från XNode)
Load(Stream, LoadOptions)

Skapar en ny XElement instans med hjälp av den angivna strömmen, om du vill bevara tomt utrymme, ange bas-URI och behålla radinformation.
Load(Stream)

Skapar en ny XElement instans med hjälp av den angivna strömmen.
Load(String, LoadOptions)

Läser in en XElement från en fil, eventuellt bevarar tomt utrymme, ställer in bas-URI och behåller radinformation.
Load(String)

Läser in en XElement från en fil.
Load(TextReader, LoadOptions)

Läser in en XElement från en TextReader, om du vill bevara tomt utrymme och behålla radinformation.
Load(TextReader)

Läser in en XElement från en TextReader.
Load(XmlReader, LoadOptions)

Läser in en XElement från ett XmlReader, som du kan använda för att bevara tomt utrymme, ange bas-URI:n och behålla radinformation.
Load(XmlReader)

Läser in en XElement från en XmlReader.
LoadAsync(Stream, LoadOptions, CancellationToken)

Asynkront skapar en ny XElement och initierar dess underliggande XML-träd med hjälp av den angivna strömmen, om du vill bevara tomt utrymme.
LoadAsync(TextReader, LoadOptions, CancellationToken)

Asynkront skapar en ny XElement och initierar dess underliggande XML-träd med hjälp av den angivna textläsaren, om du vill bevara tomt utrymme.
LoadAsync(XmlReader, LoadOptions, CancellationToken)

Asynkront skapar en ny XElement och initierar dess underliggande XML-träd med hjälp av den angivna XML-läsaren, om du vill bevara tomt utrymme.
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
Nodes()

Returnerar en samling av de underordnade noderna i det här elementet eller dokumentet i dokumentordning.

(Ärvd från XContainer)
NodesAfterSelf()

Returnerar en samling av syskonnoderna efter den här noden i dokumentordning.

(Ärvd från XNode)
NodesBeforeSelf()

Returnerar en samling av syskonnoderna före den här noden i dokumentordning.

(Ärvd från XNode)
Parse(String, LoadOptions)

Läs in en XElement från en sträng som innehåller XML, om du vill bevara tomt utrymme och behålla radinformation.
Parse(String)

Läs in en XElement från en sträng som innehåller XML.
Remove()

Tar bort den här noden från den överordnade noden.

(Ärvd från XNode)
RemoveAll()

Tar bort noder och attribut från den här XElement.
RemoveAnnotations(Type)

Tar bort anteckningarna av den angivna typen från den här XObject.

(Ärvd från XObject)
RemoveAnnotations<T>()

Tar bort anteckningarna av den angivna typen från den här XObject.

(Ärvd från XObject)
RemoveAttributes()

Tar bort attributen för den här XElement.
RemoveNodes()

Tar bort de underordnade noderna från det här dokumentet eller elementet.

(Ärvd från XContainer)
ReplaceAll(Object)

Ersätter de underordnade noderna och attributen för det här elementet med det angivna innehållet.
ReplaceAll(Object[])

Ersätter de underordnade noderna och attributen för det här elementet med det angivna innehållet.
ReplaceAttributes(Object)

Ersätter attributen för det här elementet med det angivna innehållet.
ReplaceAttributes(Object[])

Ersätter attributen för det här elementet med det angivna innehållet.
ReplaceNodes(Object)

Ersätter underordnade noder i det här dokumentet eller elementet med det angivna innehållet.

(Ärvd från XContainer)
ReplaceNodes(Object[])

Ersätter underordnade noder i det här dokumentet eller elementet med det angivna innehållet.

(Ärvd från XContainer)
ReplaceWith(Object)

Ersätter den här noden med det angivna innehållet.

(Ärvd från XNode)
ReplaceWith(Object[])

Ersätter den här noden med det angivna innehållet.

(Ärvd från XNode)
Save(Stream, SaveOptions)

Matar ut detta XElement till angivet Stream, om du vill ange formateringsbeteende.
Save(Stream)

Matar ut detta XElement till den angivna Stream.
Save(String, SaveOptions)

Serialisera det här elementet till en fil, om du vill inaktivera formatering.
Save(String)

Serialisera det här elementet till en fil.
Save(TextWriter, SaveOptions)

Serialisera det här elementet till en TextWriter, om du vill inaktivera formatering.
Save(TextWriter)

Serialisera det här elementet till en TextWriter.
Save(XmlWriter)

Serialisera det här elementet till en XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)

Asynkront matar ut detta XElement till en Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)

Asynkront matar ut detta XElement till en TextWriter.
SaveAsync(XmlWriter, CancellationToken)

Asynkront matar ut detta XElement till en XmlWriter.
SetAttributeValue(XName, Object)

Anger värdet för ett attribut, lägger till ett attribut eller tar bort ett attribut.
SetElementValue(XName, Object)

Anger värdet för ett underordnat element, lägger till ett underordnat element eller tar bort ett underordnat element.
SetValue(Object)

Anger värdet för det här elementet.
ToString()

Returnerar den indragna XML-koden för den här noden.

(Ärvd från XNode)
ToString(SaveOptions)

Returnerar XML för den här noden, om du vill inaktivera formatering.

(Ärvd från XNode)
WriteTo(XmlWriter)

Skriv det här elementet till en XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)

Skriver asynkront detta XElement till den angivna skrivaren.

Operatorer

Name Description
Explicit(XElement to Boolean)

Omvandla värdet för detta XElement till en Boolean.
Explicit(XElement to DateTime)

Omvandla värdet för detta XElement till en DateTime.
Explicit(XElement to DateTimeOffset)

Omvandla värdet för detta XAttribute till en DateTimeOffset.
Explicit(XElement to Decimal)

Omvandla värdet för detta XElement till en Decimal.
Explicit(XElement to Double)

Omvandla värdet för detta XElement till en Double.
Explicit(XElement to Guid)

Omvandla värdet för detta XElement till en Guid.
Explicit(XElement to Int32)

Omvandla värdet för detta XElement till en Int32.
Explicit(XElement to Int64)

Omvandla värdet för detta XElement till en Int64.
Explicit(XElement to Nullable<Boolean>)

Omvandla värdet för detta XElement till en Nullable<T> av Boolean.
Explicit(XElement to Nullable<DateTime>)

Omvandla värdet för detta XElement till en Nullable<T> av DateTime.
Explicit(XElement to Nullable<DateTimeOffset>)

Omvandla värdet för detta XElement till en Nullable<T> av DateTimeOffset.
Explicit(XElement to Nullable<Decimal>)

Omvandla värdet för detta XElement till en Nullable<T> av Decimal.
Explicit(XElement to Nullable<Double>)

Omvandla värdet för detta XElement till en Nullable<T> av Double.
Explicit(XElement to Nullable<Guid>)

Omvandla värdet för detta XElement till en Nullable<T> av Guid.
Explicit(XElement to Nullable<Int32>)

Omvandla värdet för detta XElement till en Nullable<T> av Int32.
Explicit(XElement to Nullable<Int64>)

Omvandla värdet för detta XElement till en Nullable<T> av Int64.
Explicit(XElement to Nullable<Single>)

Omvandla värdet för detta XElement till en Nullable<T> av Single.
Explicit(XElement to Nullable<TimeSpan>)

Omvandla värdet för detta XElement till en Nullable<T> av TimeSpan.
Explicit(XElement to Nullable<UInt32>)

Omvandla värdet för detta XElement till en Nullable<T> av UInt32.
Explicit(XElement to Nullable<UInt64>)

Omvandla värdet för detta XElement till en Nullable<T> av UInt64.
Explicit(XElement to Single)

Omvandla värdet för detta XElement till en Single.
Explicit(XElement to String)

Omvandla värdet för detta XElement till en String.
Explicit(XElement to TimeSpan)

Omvandla värdet för detta XElement till en TimeSpan.
Explicit(XElement to UInt32)

Omvandla värdet för detta XElement till en UInt32.
Explicit(XElement to UInt64)

Omvandla värdet för detta XElement till en UInt64.

Händelser

Name Description
Changed

Upphöjt när den här XObject eller någon av dess underordnade har ändrats.

(Ärvd från XObject)
Changing

Upphöjt när den här XObject eller någon av dess underordnade är på väg att ändras.

(Ärvd från XObject)

Explicita gränssnittsimplementeringar

Name Description
IXmlLineInfo.HasLineInfo()

Hämtar ett värde som anger om det här XObject innehåller radinformation eller inte.

(Ärvd från XObject)
IXmlLineInfo.LineNumber

Hämtar det radnummer som den underliggande XmlReader rapporterade för den här XObject.

(Ärvd från XObject)
IXmlLineInfo.LinePosition

Hämtar den radposition som den underliggande XmlReader rapporterade för detta XObject.

(Ärvd från XObject)
IXmlSerializable.GetSchema()

Hämtar en XML-schemadefinition som beskriver XML-representationen av det här objektet.
IXmlSerializable.ReadXml(XmlReader)

Genererar ett objekt från dess XML-representation.
IXmlSerializable.WriteXml(XmlWriter)

Konverterar ett objekt till dess XML-representation.

Tilläggsmetoder

Name Description
CreateNavigator(XNode, XmlNameTable)

Skapar en XPathNavigator för en XNode. Möjliggör XmlNameTable effektivare XPath-uttrycksbearbetning.
CreateNavigator(XNode)

Skapar en XPathNavigator för en XNode.
GetSchemaInfo(XElement)

Hämtar psvi-informationsuppsättningen (post-schema-validation) för ett verifierat element.
ToXPathNavigable(XNode)

Returnerar en accessor som gör att du kan navigera och redigera den angivna XNode.
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)

Verifierar att ett XElement underträd överensstämmer med en angiven XmlSchemaObject och , XmlSchemaSetom du vill fylla i XML-trädet med infouppsättningen efter schemavalidering (PSVI).
Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)

Den här metoden verifierar att ett XElement underträd överensstämmer med en angiven XmlSchemaObject och en XmlSchemaSet.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)

Utvärderar ett XPath-uttryck och löser namnområdesprefix med hjälp av den angivna IXmlNamespaceResolver.
XPathEvaluate(XNode, String)

Utvärderar ett XPath-uttryck.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)

Väljer ett XElement XPath-uttryck som matchar namnområdesprefix med hjälp av den angivna IXmlNamespaceResolver.
XPathSelectElement(XNode, String)

Väljer ett XElement XPath-uttryck.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)

Väljer en samling element med ett XPath-uttryck som matchar namnområdesprefix med hjälp av den angivna IXmlNamespaceResolver.
XPathSelectElements(XNode, String)

Väljer en samling element med ett XPath-uttryck.

Gäller för

Se även