XmlElement.SetAttribute Method

Definition

Sets the value of the specified attribute.

Overloads

SetAttribute(String, String)

Sets the value of the attribute with the specified name.

SetAttribute(String, String, String)

Sets the value of the attribute with the specified local name and namespace URI.

SetAttribute(String, String)

Sets the value of the attribute with the specified name.

public:
 virtual void SetAttribute(System::String ^ name, System::String ^ value);
public virtual void SetAttribute (string name, string value);
public virtual void SetAttribute (string name, string? value);
abstract member SetAttribute : string * string -> unit
override this.SetAttribute : string * string -> unit
Public Overridable Sub SetAttribute (name As String, value As String)

Parameters

name
String

The name of the attribute to create or alter. This is a qualified name. If the name contains a colon it is parsed into prefix and local name components.

value
String

The value to set for the attribute.

Exceptions

The specified name contains an invalid character.

The node is read-only.

Remarks

If an attribute with the same name is already present in the element, its value is changed to that of value. value is a simple string. It is not parsed as it is being set. Any markup, such as syntax to be recognized as an entity reference, is treated as literal text and needs to be properly escaped by the implementation when it is written out. In order to assign an attribute value that contains entity references, the user must create an XmlAttribute node plus any XmlText and XmlEntityReference nodes, build the appropriate subtree and use SetAttributeNode to assign it as the value of an attribute.

Applies to

SetAttribute(String, String, String)

Sets the value of the attribute with the specified local name and namespace URI.

public:
 virtual System::String ^ SetAttribute(System::String ^ localName, System::String ^ namespaceURI, System::String ^ value);
public virtual string SetAttribute (string localName, string namespaceURI, string value);
public virtual string? SetAttribute (string localName, string? namespaceURI, string? value);
abstract member SetAttribute : string * string * string -> string
override this.SetAttribute : string * string * string -> string
Public Overridable Function SetAttribute (localName As String, namespaceURI As String, value As String) As String

Parameters

localName
String

The local name of the attribute.

namespaceURI
String

The namespace URI of the attribute.

value
String

The value to set for the attribute.

Returns

The attribute value.

Applies to