Overzicht van LINQ naar XML-assen

Nadat u een XML-structuur hebt gemaakt of een XML-document in een XML-structuur hebt geladen, kunt u er een query op uitvoeren om elementen en kenmerken te zoeken en hun waarden op te halen. U haalt verzamelingen op via de asmethoden, ook wel assen genoemd. Sommige assen zijn methoden in de XElement en XDocument klassen die verzamelingen retourneren IEnumerable<T> . Sommige assen zijn uitbreidingsmethoden in de Extensions klasse. De assen die als uitbreidingsmethoden worden geïmplementeerd, werken op verzamelingen en retourverzamelingen.

Zoals beschreven in het overzicht van XElement-klassen, vertegenwoordigt een XElement object één elementknooppunt. De inhoud van een element kan complex zijn (ook wel gestructureerde inhoud genoemd) of kan een eenvoudig element zijn. Een eenvoudig element kan leeg zijn of kan een waarde bevatten. Als het knooppunt gestructureerde inhoud bevat, kunt u de verschillende asmethoden gebruiken om opsommingen van onderliggende elementen op te halen. De meest gebruikte asmethoden zijn Elements en Descendants.

Naast de asmethoden, die verzamelingen retourneren, zijn er nog twee methoden die u vaak in LINQ gebruikt voor XML-query's. De Element methode retourneert één XElement. De Attribute methode retourneert één XAttribute.

LinQ-query's bieden voor veel doeleinden de krachtigste manier om een boomstructuur te onderzoeken, er gegevens uit te extraheren en te transformeren. LINQ-query's werken op objecten die worden geïmplementeerd IEnumerable<T>en de LINQ naar XML-assen retourneren IEnumerable<T> van XElement verzamelingen en IEnumerable<T> verzamelingen XAttribute . U hebt deze verzamelingen nodig om uw query's uit te voeren.

Naast de asmethoden waarmee verzamelingen elementen en kenmerken worden opgehaald, zijn er asmethoden waarmee u de structuur in grote detail kunt herhalen. In plaats van met elementen en kenmerken te werken, kunt u bijvoorbeeld werken met de knooppunten van de structuur. Knooppunten zijn een nauwkeuriger granulariteitsniveau dan elementen en kenmerken. Wanneer u met knooppunten werkt, kunt u XML-opmerkingen, tekstknooppunten, verwerkingsinstructies en meer onderzoeken. Deze functionaliteit is bijvoorbeeld belangrijk voor iemand die een tekstverwerker schrijft en documenten wil opslaan als XML. Het merendeel van de XML-programmeurs heeft echter voornamelijk betrekking op elementen, kenmerken en hun waarden.

Methoden voor het ophalen van een verzameling elementen

Hier volgt een samenvatting van de methoden van de XElement klasse (of de bijbehorende basisklassen) die u aanroept XElement om een verzameling elementen te retourneren.

Wijze	Description
XNode.Ancestors	Retourneert een IEnumerable<T> van XElement de voorouders van dit element. Een overbelasting retourneert een IEnumerable<T> van XElement de voorouders die de opgegeven XNamehebben.
XContainer.Descendants	Retourneert een IEnumerable<T> van XElement de afstammelingen van dit element. Een overbelasting retourneert een IEnumerable<T> van XElement de afstammelingen die de opgegeven XNamehebben.
XContainer.Elements	Retourneert een IEnumerable<T> van XElement de onderliggende elementen van dit element. Een overbelasting retourneert een IEnumerable<T> van XElement de onderliggende elementen die de opgegeven XNamehebben.
XNode.ElementsAfterSelf	Retourneert een IEnumerable<T> van XElement de elementen die na dit element komen. Een overbelasting retourneert een IEnumerable<T> van XElement de elementen na dit element dat het opgegeven XNameelement heeft.
XNode.ElementsBeforeSelf	Retourneert een IEnumerable<T> van XElement de elementen die vóór dit element komen. Een overbelasting retourneert een IEnumerable<T> van XElement de elementen vóór dit element dat het opgegeven XNameelement heeft.
XElement.AncestorsAndSelf	Retourneert een IEnumerable<T> van XElement dit element en zijn voorouders. Een overbelasting retourneert een IEnumerable<T> van XElement de elementen die de opgegeven XNameelementen hebben.
XElement.DescendantsAndSelf	Retourneert een IEnumerable<T> van XElement dit element en de bijbehorende afstammelingen. Een overbelasting retourneert een IEnumerable<T> van XElement de elementen die de opgegeven XNameelementen hebben.

Methode voor het ophalen van één element

Met de volgende methode wordt één onderliggend element opgehaald uit een XElement object.

Wijze	Description
XContainer.Element	Retourneert het eerste onderliggende XElement object met de opgegeven XName.

Methode voor het ophalen van een verzameling kenmerken

Met de volgende methode worden kenmerken opgehaald uit een XElement object.

Wijze	Description
XElement.Attributes	Retourneert een IEnumerable<T> van XAttribute alle kenmerken.

Methode voor het ophalen van één kenmerk

Met de volgende methode wordt één kenmerk opgehaald uit een XElement object.

Wijze	Description
XElement.Attribute	Retourneert de XAttribute opgegeven XNamewaarde.