ConfigurationElement.SetAttributeValue(String, Object) Method

Reference

Definition

Namespace:: Microsoft.Web.Administration

Assembly:: Microsoft.Web.Administration.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Sets the value of the specified attribute.

public:
 void SetAttributeValue(System::String ^ attributeName, System::Object ^ value);

public void SetAttributeValue (string attributeName, object value);

member this.SetAttributeValue : string * obj -> unit

Public Sub SetAttributeValue (attributeName As String, value As Object)

Parameters

attributeName: String

The name of the attribute to change.

value: Object

The new value of the attribute.

Exceptions

ArgumentNullException

The attributeName parameter is null or empty.

Examples

The following example modifies the element with the name "TestDemo". The value is modified to "TestDemo(modified)".

// Use any of the following lines to set the attribute value.
// attribute.Value = "TestDemo(Modified)";
moduleproviderelement.SetAttributeValue(
    "name", "TestDemo(Modified)");
// moduleproviderelement["name"] = "TestDemo(Modified)";

Remarks

This method sets the attribute value and writes it to the Administration.config file. The Administration.config file is not modified until the CommitChanges method is called.

You can also set the attribute value by using the Item[] or Value properties. For best system performance, you should use the SetAttributeValue method.

Applies to

Share via