XElement.SetAttributeValue(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 atributu, přidá atribut nebo odebere atribut.

public:
 void SetAttributeValue(System::Xml::Linq::XName ^ name, System::Object ^ value);

public void SetAttributeValue (System.Xml.Linq.XName name, object value);

public void SetAttributeValue (System.Xml.Linq.XName name, object? value);

member this.SetAttributeValue : System.Xml.Linq.XName * obj -> unit

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

Parametry

name: XName

Obsahuje XName název atributu, který se má změnit.

value: Object

Hodnota, která se má přiřadit k atributu. Atribut se odebere, pokud je nullhodnota . V opačném případě se hodnota převede na řetězcovou reprezentaci a přiřadí se vlastnosti Value atributu.

Výjimky

ArgumentException

Jedná se value o instanci XObject.

Příklady

Následující příklad vytvoří element s atributem. Pak použije tuto metodu k nahrazení obsahu atributu.

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

// Add some name/value pairs.
root.SetAttributeValue("Att1", 1);
root.SetAttributeValue("Att2", 2);
root.SetAttributeValue("Att3", 3);
Console.WriteLine(root);

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

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

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

' Add some name/value pairs.
root.SetAttributeValue("Att1", 1)
root.SetAttributeValue("Att2", 2)
root.SetAttributeValue("Att3", 3)
Console.WriteLine(root)

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

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

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

<Root Att1="1" Att2="2" Att3="3" />
<Root Att1="1" Att2="22" Att3="3" />
<Root Att1="1" Att2="22" />

Poznámky

Tato metoda je navržena tak, aby usnadnila správu seznamu dvojic název/hodnota jako sady atributů. Při údržbě seznamu musíte přidat páry, upravit páry nebo odstranit páry. Pokud zavoláte tuto metodu předávání názvu, který neexistuje jako atribut, tato metoda vytvoří atribut pro vás. Pokud zavoláte tuto metodu předání názvu existujícího atributu, tato metoda upraví hodnotu atributu na hodnotu, kterou zadáte. Pokud předáte null pro value, tato metoda odebere atribut.

Tato metoda vyvolá Changed události a Changing .

Hodnota je přiřazena atributu se zadaným názvem. Pokud neexistuje žádný atribut se zadaným názvem, přidá se nový atribut. Pokud je nullhodnota , atribut se zadaným názvem (pokud existuje) se odstraní.

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

Platí pro