XAttribute.SetValue(Object) Method

Definition

Sets the value of this attribute.

public void SetValue (object value);

Parameters

value
Object

The value to assign to this attribute.

Exceptions

The value parameter is null.

The value is an XObject.

Examples

The following example creates an element with several attributes. It then changes the contents of one of the attributes.

XElement root = new XElement("Root",  
    new XAttribute("Att1", "content1"),  
    new XAttribute("Att2", "content2"),  
    new XAttribute("Att3", "content3")  
);  
XAttribute att = root.Attribute("Att2");  
att.SetValue("new content");  
Console.WriteLine(root);  

This example produces the following output:

<Root Att1="content1" Att2="new content" Att3="content3" />  

Remarks

The value is converted to its string representation and assigned to the Value property.

It is invalid to pass an instance of a class that derives from XObject, such as XElement or XAttribute.

This method will raise the Changed and the Changing events.

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

See also