PersonalizationDictionary::Remove Method (String^)

 

Removes a custom state entry based on the provided key.

Namespace:   System.Web.UI.WebControls.WebParts
Assembly:  System.Web (in System.Web.dll)

public:
virtual void Remove(
	String^ key
)

Parameters

key
Type: System::String^

The key of the entry to be removed.

Exception Condition
ArgumentNullException

key is null.

ArgumentException

key is either an empty string (""), or trimming key results in an empty string.

Internally, when you remove a custom state entry, the count of the personalization dictionary is decremented by one. Any enumerators currently active against the dictionary should be invalidated.

No error occurs if you attempt to remove a nonexistent key.

.NET Framework
Available since 2.0
Return to top
Show: