XElement.SetElementValue(XName, Object) Methode
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.
Hiermee stelt u de waarde van een onderliggend element in, voegt u een onderliggend element toe of verwijdert u een onderliggend element.
public:
void SetElementValue(System::Xml::Linq::XName ^ name, System::Object ^ value);public void SetElementValue(System.Xml.Linq.XName name, object value);public void SetElementValue(System.Xml.Linq.XName name, object? value);member this.SetElementValue : System.Xml.Linq.XName * obj -> unitPublic Sub SetElementValue (name As XName, value As Object)Parameters
- value
- Object
De waarde die moet worden toegewezen aan het onderliggende element. Het onderliggende element wordt verwijderd als de waarde is null. Anders wordt de waarde geconverteerd naar de tekenreeksweergave en toegewezen aan de Value eigenschap van het onderliggende element.
Uitzonderingen
Het value is een instantie van XObject.
Voorbeelden
In het volgende voorbeeld wordt een element met een onderliggend element gemaakt. Vervolgens wordt deze methode gebruikt om de waarde van het onderliggende element in te stellen.
// 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)
In dit voorbeeld wordt de volgende uitvoer gegenereerd:
<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>
Opmerkingen
Deze methode is ontworpen om een lijst met naam-/waardeparen eenvoudig te onderhouden als een set onderliggende elementen. Wanneer u de lijst onderhoudt, moet u paren toevoegen, paren wijzigen of paren verwijderen. Als u deze methode aanroept die een naam doorgeeft die niet bestaat als onderliggend element, wordt met deze methode een onderliggend element voor u gemaakt. Als u deze methode aanroept die de naam van een bestaand onderliggend element doorgeeft, wijzigt deze methode de waarde van het onderliggende element in de waarde die u opgeeft. Als u doorgeeft nullvalue, wordt met deze methode het onderliggende element verwijderd.
Met deze methode worden gebeurtenissen gegenereerd.
De waarde wordt toegewezen aan het eerste onderliggende element met de opgegeven naam. Als er geen onderliggend element met de opgegeven naam bestaat, wordt er een nieuw onderliggend element toegevoegd. Als de waarde null is, wordt het eerste onderliggende element met de opgegeven naam, indien aanwezig, verwijderd.
Met deze methode worden geen onderliggende knooppunten of kenmerken toegevoegd aan het opgegeven onderliggende element. Met deze methode wordt een uitzondering gegenereerd als een object dat is afgeleid van XObject , wordt doorgegeven als value.
Zie Naam-waardeparen onderhouden voor meer informatie.
