XElement Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Vertegenwoordigt een XML-element. Zie Het overzicht van XElement-klassen en de sectie Opmerkingen op deze pagina voor gebruiksgegevens en voorbeelden.
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
- Overname
- Implementeringen
Voorbeelden
In het volgende voorbeeld wordt een XML-structuur gemaakt. De inhoud van het nieuwe element is afkomstig van een LINQ-query.
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)
In dit voorbeeld wordt de volgende uitvoer gegenereerd:
<Root>
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
Hier volgt hetzelfde voorbeeld, maar in dit geval bevindt de XML zich in een naamruimte. Zie Werken met XML-naamruimten voor meer informatie.
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
In dit voorbeeld wordt de volgende uitvoer gegenereerd:
<Root xmlns="http://www.adventure-works.com">
<Child3>3</Child3>
<Child4>4</Child4>
<Child5>5</Child5>
</Root>
Opmerkingen
Deze klasse vertegenwoordigt een XML-element, de fundamentele XML-constructie. Zie Het overzicht van XElement-klassen voor andere gebruiksgegevens.
Een element heeft een XName, optioneel een of meer kenmerken en kan eventueel inhoud bevatten (zie voor meer informatie Nodes).
Een XElement kan de volgende typen inhoud bevatten:
Zie XElement voor meer informatie over de geldige inhoud van een object.
XElement afgeleid van XContainer, die is afgeleid van XNode.
Sommige XElement methoden kunnen worden gebruikt vanuit XAML. Zie LINQ naar XML Dynamic Propertiesvoor meer informatie.
Constructors
| Name | Description |
|---|---|
| XElement(XElement) |
Initialiseert een nieuw exemplaar van de XElement klasse van een ander XElement object. |
| XElement(XName, Object) |
Initialiseert een nieuw exemplaar van de XElement klasse met de opgegeven naam en inhoud. |
| XElement(XName, Object[]) |
Initialiseert een nieuw exemplaar van de XElement klasse met de opgegeven naam en inhoud. |
| XElement(XName) |
Initialiseert een nieuw exemplaar van de XElement klasse met de opgegeven naam. |
| XElement(XStreamingElement) |
Initialiseert een nieuw exemplaar van de XElement klasse van een XStreamingElement object. |
Eigenschappen
| Name | Description |
|---|---|
| BaseUri |
Hiermee haalt u de basis-URI op.XObject (Overgenomen van XObject) |
| Document |
Krijgt het XDocument voor dit XObject. (Overgenomen van XObject) |
| EmptySequence |
Hiermee haalt u een lege verzameling elementen op. |
| FirstAttribute |
Hiermee haalt u het eerste kenmerk van dit element op. |
| FirstNode |
Hiermee wordt het eerste onderliggende knooppunt van dit knooppunt opgehaald. (Overgenomen van XContainer) |
| HasAttributes |
Hiermee wordt een waarde opgehaald die aangeeft of dit element ten minste één kenmerk heeft. |
| HasElements |
Hiermee wordt een waarde opgehaald die aangeeft of dit element ten minste één onderliggend element heeft. |
| IsEmpty |
Hiermee wordt een waarde opgehaald die aangeeft of dit element geen inhoud bevat. |
| LastAttribute |
Hiermee haalt u het laatste kenmerk van dit element op. |
| LastNode |
Hiermee wordt het laatste onderliggende knooppunt van dit knooppunt opgehaald. (Overgenomen van XContainer) |
| Name |
Hiermee haalt u de naam van dit element op of stelt u deze in. |
| NextNode |
Hiermee wordt het volgende knooppunt op hetzelfde niveau van dit knooppunt opgehaald. (Overgenomen van XNode) |
| NodeType |
Hiermee wordt het knooppunttype voor dit knooppunt opgehaald. |
| Parent |
Haalt de bovenliggende XElement van deze XObject. (Overgenomen van XObject) |
| PreviousNode |
Hiermee wordt het vorige knooppunt op hetzelfde niveau van dit knooppunt opgehaald. (Overgenomen van XNode) |
| Value |
Hiermee haalt u de samengevoegde tekstinhoud van dit element op of stelt u deze in. |
Methoden
| Name | Description |
|---|---|
| Add(Object) |
Hiermee voegt u de opgegeven inhoud toe als onderliggende elementen van dit XContainerbestand. (Overgenomen van XContainer) |
| Add(Object[]) |
Hiermee voegt u de opgegeven inhoud toe als onderliggende elementen van dit XContainerbestand. (Overgenomen van XContainer) |
| AddAfterSelf(Object) |
Voegt de opgegeven inhoud direct na dit knooppunt toe. (Overgenomen van XNode) |
| AddAfterSelf(Object[]) |
Voegt de opgegeven inhoud direct na dit knooppunt toe. (Overgenomen van XNode) |
| AddAnnotation(Object) |
Hiermee voegt u een object toe aan de aantekeningslijst van dit XObjectobject. (Overgenomen van XObject) |
| AddBeforeSelf(Object) |
Voegt de opgegeven inhoud direct vóór dit knooppunt toe. (Overgenomen van XNode) |
| AddBeforeSelf(Object[]) |
Voegt de opgegeven inhoud direct vóór dit knooppunt toe. (Overgenomen van XNode) |
| AddFirst(Object) |
Hiermee voegt u de opgegeven inhoud toe als de eerste onderliggende elementen van dit document of element. (Overgenomen van XContainer) |
| AddFirst(Object[]) |
Hiermee voegt u de opgegeven inhoud toe als de eerste onderliggende elementen van dit document of element. (Overgenomen van XContainer) |
| Ancestors() |
Retourneert een verzameling van de bovenliggende elementen van dit knooppunt. (Overgenomen van XNode) |
| Ancestors(XName) |
Retourneert een gefilterde verzameling van de bovenliggende elementen van dit knooppunt. Alleen elementen die een overeenkomst XName hebben, worden opgenomen in de verzameling. (Overgenomen van XNode) |
| AncestorsAndSelf() |
Retourneert een verzameling elementen die dit element bevatten en de bovenliggende elementen van dit element. |
| AncestorsAndSelf(XName) |
Retourneert een gefilterde verzameling elementen die dit element bevatten en de bovenliggende elementen van dit element. Alleen elementen die een overeenkomst XName hebben, worden opgenomen in de verzameling. |
| Annotation(Type) |
Hiermee haalt u het eerste aantekeningsobject van het opgegeven type op.XObject (Overgenomen van XObject) |
| Annotation<T>() |
Hiermee haalt u het eerste aantekeningsobject van het opgegeven type op.XObject (Overgenomen van XObject) |
| Annotations(Type) |
Hiermee haalt u een verzameling aantekeningen van het opgegeven type op.XObject (Overgenomen van XObject) |
| Annotations<T>() |
Hiermee haalt u een verzameling aantekeningen van het opgegeven type op.XObject (Overgenomen van XObject) |
| Attribute(XName) |
Geeft als resultaat de XAttributeXElement opgegeven XNamewaarde. |
| Attributes() |
Hiermee wordt een verzameling kenmerken van dit element geretourneerd. |
| Attributes(XName) |
Hiermee wordt een gefilterde verzameling kenmerken van dit element geretourneerd. Alleen kenmerken die een overeenkomst XName hebben, worden opgenomen in de verzameling. |
| CreateReader() |
Hiermee maakt u een XmlReader voor dit knooppunt. (Overgenomen van XNode) |
| CreateReader(ReaderOptions) |
Hiermee maakt u een XmlReader met de opties die zijn opgegeven door de |
| CreateWriter() |
Hiermee maakt u een XmlWriter die kan worden gebruikt om knooppunten toe te voegen aan de XContainer. (Overgenomen van XContainer) |
| DescendantNodes() |
Retourneert een verzameling van de onderliggende knooppunten voor dit document of element, in documentvolgorde. (Overgenomen van XContainer) |
| DescendantNodesAndSelf() |
Retourneert een verzameling knooppunten die dit element bevatten, en alle onderliggende knooppunten van dit element, in documentvolgorde. |
| Descendants() |
Retourneert een verzameling van de onderliggende elementen voor dit document of element, in documentvolgorde. (Overgenomen van XContainer) |
| Descendants(XName) |
Retourneert een gefilterde verzameling van de onderliggende elementen voor dit document of element, in documentvolgorde. Alleen elementen die een overeenkomst XName hebben, worden opgenomen in de verzameling. (Overgenomen van XContainer) |
| DescendantsAndSelf() |
Retourneert een verzameling elementen die dit element bevatten, en alle onderliggende elementen van dit element, in documentvolgorde. |
| DescendantsAndSelf(XName) |
Retourneert een gefilterde verzameling elementen die dit element bevatten, en alle onderliggende elementen van dit element, in documentvolgorde. Alleen elementen die een overeenkomst XName hebben, worden opgenomen in de verzameling. |
| Element(XName) |
Hiermee haalt u het eerste onderliggende element (in documentvolgorde) op met het opgegeven XName. (Overgenomen van XContainer) |
| Elements() |
Retourneert een verzameling onderliggende elementen van dit element of document, in documentvolgorde. (Overgenomen van XContainer) |
| Elements(XName) |
Retourneert een gefilterde verzameling van de onderliggende elementen van dit element of document, in documentvolgorde. Alleen elementen die een overeenkomst XName hebben, worden opgenomen in de verzameling. (Overgenomen van XContainer) |
| ElementsAfterSelf() |
Retourneert een verzameling van de elementen op hetzelfde niveau na dit knooppunt, in documentvolgorde. (Overgenomen van XNode) |
| ElementsAfterSelf(XName) |
Retourneert een gefilterde verzameling van de elementen op hetzelfde niveau na dit knooppunt, in documentvolgorde. Alleen elementen die een overeenkomst XName hebben, worden opgenomen in de verzameling. (Overgenomen van XNode) |
| ElementsBeforeSelf() |
Retourneert een verzameling van de elementen op hetzelfde niveau vóór dit knooppunt, in documentvolgorde. (Overgenomen van XNode) |
| ElementsBeforeSelf(XName) |
Retourneert een gefilterde verzameling van de elementen op hetzelfde niveau vóór dit knooppunt, in documentvolgorde. Alleen elementen die een overeenkomst XName hebben, worden opgenomen in de verzameling. (Overgenomen van XNode) |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetDefaultNamespace() |
Hiermee wordt de standaardwaarde XNamespace van deze XElement. |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetNamespaceOfPrefix(String) |
Hiermee wordt de naamruimte opgehaald die aan een bepaald voorvoegsel is gekoppeld.XElement |
| GetPrefixOfNamespace(XNamespace) |
Hiermee wordt het voorvoegsel opgehaald dat aan een naamruimte is XElementgekoppeld. |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| IsAfter(XNode) |
Bepaalt of het huidige knooppunt wordt weergegeven na een opgegeven knooppunt in documentvolgorde. (Overgenomen van XNode) |
| IsBefore(XNode) |
Bepaalt of het huidige knooppunt wordt weergegeven vóór een opgegeven knooppunt in documentvolgorde. (Overgenomen van XNode) |
| Load(Stream, LoadOptions) |
Hiermee maakt u een nieuw XElement exemplaar met behulp van de opgegeven stroom, eventueel witruimte behouden, de basis-URI instellen en regelgegevens behouden. |
| Load(Stream) |
Hiermee maakt u een nieuw XElement exemplaar met behulp van de opgegeven stream. |
| Load(String, LoadOptions) |
Laadt een XElement bestand, eventueel witruimte behouden, de basis-URI instellen en regelgegevens behouden. |
| Load(String) |
Hiermee wordt een XElement bestand geladen. |
| Load(TextReader, LoadOptions) |
Laadt een XElement van een TextReader, eventueel behoudende witruimte en behoudt regelinformatie. |
| Load(TextReader) |
Laadt een XElement van een TextReader. |
| Load(XmlReader, LoadOptions) |
Laadt een XElement van een XmlReader, eventueel behoudende witruimte, het instellen van de basis-URI en het behouden van regelgegevens. |
| Load(XmlReader) | |
| LoadAsync(Stream, LoadOptions, CancellationToken) |
Asynchroon maakt een nieuwe XElement en initialiseert de onderliggende XML-structuur met behulp van de opgegeven stroom, eventueel witruimte behouden. |
| LoadAsync(TextReader, LoadOptions, CancellationToken) |
Asynchroon maakt een nieuwe XElement en initialiseert de onderliggende XML-structuur met behulp van de opgegeven tekstlezer, eventueel witruimte behouden. |
| LoadAsync(XmlReader, LoadOptions, CancellationToken) |
Asynchroon maakt een nieuwe XElement en initialiseert de onderliggende XML-structuur met behulp van de opgegeven XML-lezer, eventueel witruimte behouden. |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| Nodes() |
Retourneert een verzameling van de onderliggende knooppunten van dit element of document, in documentvolgorde. (Overgenomen van XContainer) |
| NodesAfterSelf() |
Retourneert een verzameling van de knooppunten op hetzelfde niveau na dit knooppunt, in documentvolgorde. (Overgenomen van XNode) |
| NodesBeforeSelf() |
Retourneert een verzameling van de knooppunten op hetzelfde niveau vóór dit knooppunt, in documentvolgorde. (Overgenomen van XNode) |
| Parse(String, LoadOptions) |
XElement Een tekenreeks laden die XML bevat, eventueel witruimte behouden en regelgegevens behouden. |
| Parse(String) |
Laad een XElement tekenreeks die XML bevat. |
| Remove() |
Hiermee verwijdert u dit knooppunt van het bovenliggende knooppunt. (Overgenomen van XNode) |
| RemoveAll() |
Hiermee verwijdert u knooppunten en kenmerken.XElement |
| RemoveAnnotations(Type) |
Hiermee verwijdert u de aantekeningen van het opgegeven type.XObject (Overgenomen van XObject) |
| RemoveAnnotations<T>() |
Hiermee verwijdert u de aantekeningen van het opgegeven type.XObject (Overgenomen van XObject) |
| RemoveAttributes() |
Hiermee verwijdert u de kenmerken van deze XElement. |
| RemoveNodes() |
Hiermee verwijdert u de onderliggende knooppunten uit dit document of element. (Overgenomen van XContainer) |
| ReplaceAll(Object) |
Vervangt de onderliggende knooppunten en de kenmerken van dit element door de opgegeven inhoud. |
| ReplaceAll(Object[]) |
Vervangt de onderliggende knooppunten en de kenmerken van dit element door de opgegeven inhoud. |
| ReplaceAttributes(Object) |
Vervangt de kenmerken van dit element door de opgegeven inhoud. |
| ReplaceAttributes(Object[]) |
Vervangt de kenmerken van dit element door de opgegeven inhoud. |
| ReplaceNodes(Object) |
Vervangt de onderliggende knooppunten van dit document of element door de opgegeven inhoud. (Overgenomen van XContainer) |
| ReplaceNodes(Object[]) |
Vervangt de onderliggende knooppunten van dit document of element door de opgegeven inhoud. (Overgenomen van XContainer) |
| ReplaceWith(Object) |
Vervangt dit knooppunt door de opgegeven inhoud. (Overgenomen van XNode) |
| ReplaceWith(Object[]) |
Vervangt dit knooppunt door de opgegeven inhoud. (Overgenomen van XNode) |
| Save(Stream, SaveOptions) |
Hiermee wordt dit XElement uitgevoerd naar het opgegeven Stream, eventueel opmaakgedrag opgeven. |
| Save(Stream) |
Hiermee wordt dit XElement uitgevoerd naar de opgegeven Stream. |
| Save(String, SaveOptions) |
Serialiseer dit element naar een bestand, optioneel het uitschakelen van opmaak. |
| Save(String) |
Serialiseer dit element naar een bestand. |
| Save(TextWriter, SaveOptions) |
Serialiseer dit element naar een TextWriter, eventueel uitgeschakelde opmaak. |
| Save(TextWriter) |
Serialiseer dit element in een TextWriter. |
| Save(XmlWriter) |
Serialiseer dit element in een XmlWriter. |
| SaveAsync(Stream, SaveOptions, CancellationToken) | |
| SaveAsync(TextWriter, SaveOptions, CancellationToken) |
Asynchroon voert dit XElement uit naar een TextWriter. |
| SaveAsync(XmlWriter, CancellationToken) | |
| SetAttributeValue(XName, Object) |
Hiermee stelt u de waarde van een kenmerk in, voegt u een kenmerk toe of verwijdert u een kenmerk. |
| SetElementValue(XName, Object) |
Hiermee stelt u de waarde van een onderliggend element in, voegt u een onderliggend element toe of verwijdert u een onderliggend element. |
| SetValue(Object) |
Hiermee stelt u de waarde van dit element in. |
| ToString() |
Retourneert de ingesprongen XML voor dit knooppunt. (Overgenomen van XNode) |
| ToString(SaveOptions) |
Retourneert de XML voor dit knooppunt, optioneel het uitschakelen van opmaak. (Overgenomen van XNode) |
| WriteTo(XmlWriter) |
Schrijf dit element naar een XmlWriter. |
| WriteToAsync(XmlWriter, CancellationToken) |
Hiermee schrijft u dit XElement asynchroon naar de opgegeven schrijver. |
Operators
gebeurtenis
| Name | Description |
|---|---|
| Changed |
Opgevoed wanneer deze XObject of een van zijn nakomelingen is veranderd. (Overgenomen van XObject) |
| Changing |
Verhoogd wanneer deze XObject of een van zijn nakomelingen op het punt staat te veranderen. (Overgenomen van XObject) |
Expliciete interface-implementaties
| Name | Description |
|---|---|
| IXmlLineInfo.HasLineInfo() |
Hiermee wordt een waarde opgehaald die aangeeft of dit XObject regelgegevens bevat. (Overgenomen van XObject) |
| IXmlLineInfo.LineNumber |
Hiermee haalt u het regelnummer op dat de onderliggende gerapporteerde XmlReader waarde hiervoor XObjectis. (Overgenomen van XObject) |
| IXmlLineInfo.LinePosition |
Hiermee haalt u de lijnpositie op die door de onderliggende XmlReader gegevens voor dit XObjectwordt gerapporteerd. (Overgenomen van XObject) |
| IXmlSerializable.GetSchema() |
Hiermee haalt u een XML-schemadefinitie op die de XML-weergave van dit object beschrijft. |
| IXmlSerializable.ReadXml(XmlReader) |
Hiermee wordt een object gegenereerd op basis van de XML-weergave. |
| IXmlSerializable.WriteXml(XmlWriter) |
Converteert een object naar de XML-weergave. |
Extensiemethoden
| Name | Description |
|---|---|
| CreateNavigator(XNode, XmlNameTable) |
Hiermee maakt u een XPathNavigator voor een XNode. De XmlNameTable functie maakt efficiëntere verwerking van XPath-expressies mogelijk. |
| CreateNavigator(XNode) |
Hiermee maakt u een XPathNavigator voor een XNode. |
| GetSchemaInfo(XElement) |
Hiermee haalt u de post-schemavalidatie-infoset (PSVI) van een gevalideerd element op. |
| ToXPathNavigable(XNode) |
Hiermee wordt een toegangsfunctie geretourneerd waarmee u kunt navigeren en bewerken.XNode |
| Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean) |
Valideert dat een XElement substructuur voldoet aan een opgegeven XmlSchemaObject en een XmlSchemaSet, eventueel een XML-structuur vullen met de post-schemavalidatie-infoset (PSVI). |
| Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler) |
Met deze methode wordt gevalideerd of een XElement substructuur voldoet aan een opgegeven XmlSchemaObject en een XmlSchemaSet. |
| XPathEvaluate(XNode, String, IXmlNamespaceResolver) |
Evalueert een XPath-expressie, waarbij naamruimtevoorvoegsels worden omgezet met behulp van de opgegeven IXmlNamespaceResolver. |
| XPathEvaluate(XNode, String) |
Evalueert een XPath-expressie. |
| XPathSelectElement(XNode, String, IXmlNamespaceResolver) |
Hiermee selecteert XElement u een XPath-expressie, waarbij naamruimtevoorvoegsels worden omgezet met behulp van de opgegeven IXmlNamespaceResolver. |
| XPathSelectElement(XNode, String) |
Hiermee selecteert u een XElement XPath-expressie. |
| XPathSelectElements(XNode, String, IXmlNamespaceResolver) |
Selecteert een verzameling elementen met behulp van een XPath-expressie, waarbij naamruimtevoorvoegsels worden omgezet met behulp van de opgegeven IXmlNamespaceResolver. |
| XPathSelectElements(XNode, String) |
Hiermee selecteert u een verzameling elementen met behulp van een XPath-expressie. |