XElement.SetAttributeValue(XName, Object) Metoda

Definice

Nastaví hodnotu atributu, přidá atribut nebo odebere atribut.Sets the value of an attribute, adds an attribute, or removes an attribute.

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

Obsahující XName název atributu, který má být změněn.An XName that contains the name of the attribute to change.

value
Object

Hodnota, která má být přiřazena k atributu.The value to assign to the attribute. Atribut se odebere, pokud je hodnota null .The attribute is removed if the value is null. V opačném případě je hodnota převedena na řetězcové vyjádření a přiřazena Value vlastnosti atributu.Otherwise, the value is converted to its string representation and assigned to the Value property of the attribute.

Výjimky

valueJe instancí XObject .The value is an instance of XObject.

Příklady

Následující příklad vytvoří prvek s atributem.The following example creates an element with an attribute. Pak použije tuto metodu k nahrazení obsahu atributu.It then uses this method to replace the content of the attribute.

// 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:This example produces the following output:

<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 udržování seznamu párů název/hodnota jako sadu atributů.This method is designed to make it easy to maintain a list of name/value pairs as a set of attributes. Při údržbě seznamu je nutné přidat páry, upravit páry nebo odstranit páry.When maintaining the list, you need to add pairs, modify pairs, or delete pairs. Pokud zavoláte tuto metodu předání názvu, který neexistuje jako atribut, tato metoda vytvoří atribut.If you call this method passing a name that does not exist as an attribute, this method creates an attribute for you. Pokud zavoláte tuto metodu, která předává název existujícího atributu, tato metoda upraví hodnotu atributu na hodnotu, kterou zadáte.If you call this method passing the name of an existing attribute, this method modifies the value of the attribute to the value that you specify. Pokud předáte null pro value , tato metoda odebere atribut.If you pass null for value, this method removes the attribute.

Tato metoda vyvolá Changed Changing události a.This method will raise the Changed and the Changing events.

Hodnota je přiřazena k atributu se zadaným názvem.The value is assigned to the attribute with the specified name. Pokud žádný atribut se zadaným názvem neexistuje, je přidán nový atribut.If no attribute with the specified name exists, a new attribute is added. Pokud je hodnota null , atribut se zadaným názvem (pokud existuje) je odstraněn.If the value is null, the attribute with the specified name, if any, is deleted.

Další informace najdete v tématu zachování párů název-hodnota.For more information, see Maintain name-value pairs.

Platí pro

Viz také