XElement.SetElementValue(XName, Object) Metod

Definition

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

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

public:
 void SetElementValue(System::Xml::Linq::XName ^ name, System::Object ^ value);
public void SetElementValue(System.Xml.Linq.XName name, object value);
member this.SetElementValue : System.Xml.Linq.XName * obj -> unit
Public Sub SetElementValue (name As XName, value As Object)

Parametrar

name
XName

En XName som innehåller namnet på det underordnade element som ska ändras.

value
Object

Värdet som ska tilldelas till det underordnade elementet. Det underordnade elementet tas bort om värdet är null. Annars konverteras värdet till dess strängrepresentation och tilldelas egenskapen för Value det underordnade elementet.

Undantag

ArgumentException

value är en instans av XObject.

Exempel

I följande exempel skapas ett element med ett underordnat element. Den använder sedan den här metoden för att ange värdet för det underordnade elementet.

// Create an element with no content
XElement root = new XElement("Root");

// Add some name/value pairs.
root.SetElementValue("Ele1", 1);
root.SetElementValue("Ele2", 2);
root.SetElementValue("Ele3", 3);
Console.WriteLine(root);

// Modify one of the name/value pairs.
root.SetElementValue("Ele2", 22);
Console.WriteLine(root);

// Remove one of the name/value pairs.
root.SetElementValue("Ele3", null);
Console.WriteLine(root);

' Create an element with no content.
Dim root As XElement = <Root/>

' Add some name/value pairs.
root.SetElementValue("Ele1", 1)
root.SetElementValue("Ele2", 2)
root.SetElementValue("Ele3", 3)
Console.WriteLine(root)

' Modify one of the name/value pairs.
root.SetElementValue("Ele2", 22)
Console.WriteLine(root)

' Remove one of the name/value pairs.
root.SetElementValue("Ele3", Nothing)
Console.WriteLine(root)

Det här exemplet genererar följande utdata:

<Root>
  <Ele1>1</Ele1>
  <Ele2>2</Ele2>
  <Ele3>3</Ele3>
</Root>
<Root>
  <Ele1>1</Ele1>
  <Ele2>22</Ele2>
  <Ele3>3</Ele3>
</Root>
<Root>
  <Ele1>1</Ele1>
  <Ele2>22</Ele2>
</Root>

Kommentarer

Den här metoden är utformad för att göra det enkelt att underhålla en lista över namn/värde-par som en uppsättning underordnade element. När du underhåller listan måste du lägga till par, ändra par eller ta bort par. Om du anropar den här metoden och skickar ett namn som inte finns som ett underordnat element skapar den här metoden ett underordnat element åt dig. Om du anropar den här metoden och skickar namnet på ett befintligt underordnat element ändrar den här metoden värdet för det underordnade elementet till det värde som du anger. Om du skickar null för valuetar den här metoden bort det underordnade elementet.

Den här metoden genererar händelser.

Värdet tilldelas till det första underordnade elementet med det angivna namnet. Om det inte finns något underordnat element med det angivna namnet läggs ett nytt underordnat element till. Om värdet är null tas det första underordnade elementet med det angivna namnet bort.

Den här metoden lägger inte till underordnade noder eller attribut till det angivna underordnade elementet. Den här metoden genererar ett undantag om ett objekt som härleds från XObject skickas som value.

Mer information finns i Underhålla namn/värde-par.

Gäller för

Se även