Sdílet prostřednictvím

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
Zdroj:
XElement.cs
Zdroj:
XElement.cs
Zdroj:
XElement.cs

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

Viz také