Geldige inhoud van XElement- en XDocument-objecten (LINQ naar XML)

In dit artikel worden de geldige argumenten beschreven die kunnen worden doorgegeven aan constructors en methoden die u gebruikt om inhoud toe te voegen aan elementen en documenten.

Geldige typen voor de XElement-constructor

Query's evalueren vaak IEnumerable<T> van XElement of IEnumerable<T> van XAttribute. U kunt verzamelingen van XElement of XAttribute objecten doorgeven aan de XElement constructor. Daarom is het handig om de resultaten van een query als inhoud door te geven aan methoden en constructors die u gebruikt om XML-structuren te vullen.

Wanneer u eenvoudige inhoud toevoegt, kunnen verschillende typen worden doorgegeven aan deze methode, waaronder:

Bij het toevoegen van complexe inhoud kunnen verschillende typen worden doorgegeven aan deze methode, waaronder:

Als een object IEnumerable<T>implementeert, wordt de verzameling in het object geïnventariseerd en worden alle items in de verzameling toegevoegd. Als de verzameling XNode of XAttribute objecten bevat, wordt elk item in de verzameling afzonderlijk toegevoegd. Als de verzameling tekst (of objecten bevat die naar tekst worden geconverteerd), wordt de tekst in de verzameling samengevoegd en toegevoegd als één tekstknooppunt.

Als inhoud is null, wordt er niets toegevoegd. Wanneer u een verzameling doorgeeft, kunnen de items in de verzameling nullworden. Een null item in de verzameling heeft geen effect op de boomstructuur.

Een toegevoegd kenmerk moet een unieke naam hebben binnen het bijbehorende element.

Wanneer u XNode of XAttribute objecten toevoegt en de nieuwe inhoud geen bovenliggende inhoud heeft, worden de objecten gewoon gekoppeld aan de XML-structuur. Als de nieuwe inhoud al een bovenliggende ouder heeft en deel uitmaakt van een andere XML-structuur, wordt de nieuwe inhoud gekloond en vervolgens aan de XML-structuur gekoppeld.

Geldige typen voor de XDocument-constructor

Kenmerken en eenvoudige inhoud kunnen niet worden toegevoegd aan een document.

Er zijn niet veel scenario's waarvoor u een XDocumentmoet maken. In plaats daarvan kunt u uw XML-structuren meestal maken met een XElement wortelknooppunt. Tenzij u een specifiek vereiste hebt om een document te maken (bijvoorbeeld omdat u verwerkingsinstructies en opmerkingen op het hoogste niveau moet maken of u documenttypen moet ondersteunen), is het vaak handiger om XElement als hoofdknooppunt te gebruiken.

Geldige typen voor de XDocument constructor omvatten de volgende:

  • Nul of één XDocumentType objecten. De documenttypen moeten vóór het element komen.
  • Nul of één element.
  • Nul of meer opmerkingen.
  • Nul of meer verwerkingsinstructies.
  • Nul of meer tekstknooppunten die alleen witruimte bevatten.

Constructors en functies voor het toevoegen van inhoud

Met de volgende methoden kunt u subinhoud toevoegen aan een XElement of XDocument:

Methode Beschrijving
XElement Maakt een XElement.
XDocument Maakt een XDocument.
Add Voegt toe aan het einde van de kindinhoud van de XElement of XDocument.
AddAfterSelf Voegt inhoud toe na de XNode.
AddBeforeSelf Voegt inhoud toe vóór de XNode.
AddFirst Voegt inhoud toe aan het begin van de subinhoud van de XContainer.
ReplaceAll Vervangt alle inhoud (subknooppunten en kenmerken) van een XElement-element.
ReplaceAttributes Vervangt de kenmerken van een XElement.
ReplaceNodes Vervangt de childknooppunten door nieuwe inhoud.
ReplaceWith Hiermee vervangt u een knooppunt door nieuwe inhoud.

Zie ook

  • Last updated on