XElement.SetElementValue(XName, Object) Metoda

Reference

Definice

Obor názvů:: System.Xml.Linq

Sestavení:: System.Xml.XDocument.dll

Sestavení:: System.Xml.Linq.dll

Sestavení:: netstandard.dll

Source:: XElement.cs

Source:: XElement.cs

Source:: XElement.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Nastaví hodnotu podřízeného elementu, přidá podřízený prvek nebo odebere podřízený prvek.

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 -> unit

Public Sub SetElementValue (name As XName, value As Object)

Parametry

name: XName

Obsahuje XName název podřízeného prvku, který chcete změnit.

value: Object

Hodnota, která má být přiřazena podřízeného elementu. Pokud je nullhodnota , odebere se podřízený element. V opačném případě se hodnota převede na řetězcovou reprezentaci a přiřadí se vlastnosti Value podřízeného elementu.

Výjimky

ArgumentException

Je value instancí XObject.

Příklady

Následující příklad vytvoří element s podřízeným elementem. Pak použije tuto metodu k nastavení hodnoty podřízeného elementu.

// 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)

Tento příklad vytvoří následující výstup:

<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>

Poznámky

Tato metoda je navržena tak, aby bylo možné snadno udržovat seznam dvojic název/hodnota jako sadu podřízených prvků. Při údržbě seznamu je potřeba přidat páry, upravit páry nebo je odstranit. Pokud zavoláte tuto metodu předávání názvu, který neexistuje jako podřízený prvek, tato metoda vytvoří podřízený prvek za vás. Pokud zavoláte tuto metodu předávání názvu existujícího podřízeného elementu, tato metoda upraví hodnotu podřízeného prvku na hodnotu, kterou zadáte. Pokud předáte null pro value, tato metoda odebere podřízený prvek.

Tato metoda vyvolá události.

Hodnota je přiřazena prvnímu podřízeného prvku se zadaným názvem. Pokud neexistuje žádný podřízený element se zadaným názvem, přidá se nový podřízený element. Pokud je hodnota null, první podřízený prvek se zadaným názvem(pokud existuje) se odstraní.

Tato metoda nepřidá podřízené uzly nebo atributy do zadaného podřízeného elementu. Tato metoda vyvolá výjimku, pokud je jakýkoli objekt odvozený z XObject předán jako value.

Další informace najdete v tématu Údržba párů název-hodnota.

Platí pro