Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

XAttribute.SetValue Method

Sets the value of this attribute.

Namespace:  System.Xml.Linq
Assemblies:   System.Xml.Linq (in System.Xml.Linq.dll)
  System.Xml.XDocument (in System.Xml.XDocument.dll)

public void SetValue(
	Object value
)

Parameters

value
Type: System.Object

The value to assign to this attribute.

ExceptionCondition
ArgumentNullException

The value parameter is null.

ArgumentException

The value is an XObject.

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.

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" />

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft