XElement.SetAttributeValue(XName, Object) Metoda

Definice

Obor názvů:

System.Xml.Linq

Sestavení:

netstandard.dll, System.Xml.XDocument.dll

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

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 je odebrán, pokud je nullhodnota . V opačném případě se hodnota převede na řetězcové vyjádření a přiřadí vlastnosti Value atributu.

Výjimky

ArgumentException

Jedná se value o instanci XObject.

Příklady

Následující příklad vytvoří prvek s atributem. Pak tuto metodu použije 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žená tak, aby usnadnila údržbu seznamu párů name/value jako sady atributů. Při údržbě seznamu je potřeba přidat páry, upravit páry nebo odstranit páry. Pokud zavoláte tuto metodu, která předává název, který neexistuje jako atribut, tato metoda vytvoří atribut za vás. Pokud zavoláte tuto metodu, která předává název existujícího atributu, tato metoda upraví hodnotu atributu na zadaná hodnota. Pokud předáte null , valuetato metoda odebere atribut.

Tato metoda vyvolá Changed události a Changing události.

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, je odstraněn.

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

Viz také

• SetElementValue(XName, Object)
• System.Xml.Linq.XAttribute.SetValue(System.Object)
• System.Xml.Linq.XElement.SetValue(System.Object)
• Přehled LINQ to XML
• Údržba párů název-hodnota