SecurityElement::AddAttribute Method (String^, String^)

.NET Framework (current version)

Adds a name/value attribute to an XML element.

Namespace: System.Security
Assembly: mscorlib (in mscorlib.dll)

Syntax

public:
void AddAttribute(
	String^ name,
	String^ value
)

Parameters

name: Type: System::String^
The name of the attribute.

value: Type: System::String^
The value of the attribute.

Exceptions

Exception	Condition
ArgumentNullException	The name parameter or value parameter is null.
ArgumentException	The name parameter or value parameter is invalid in XML. -or- An attribute with the name specified by the name parameter already exists.

Remarks

Names and values in attributes should only contain valid XML attribute characters. XML attribute names must be unique. Use Escape to remove invalid characters from the string.

There is no support for quoted strings, so strings for name/value pairs should not contain quotes or other characters requiring quoting.

Examples

The following code shows the use of the AddAttribute method to add a name/value attribute to an XML element. This code example is part of a larger example provided for the SecurityElement class.

C++

windowsRoleElement->AddAttribute( L"version", L"1.00" );

Version Information

.NET Framework
Available since 1.1