PersonalizationProvider.DetermineUserCapabilities Method (WebPartManager)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Returns a dictionary containing WebPartUserCapability instances that represent the personalization-related capabilities of the currently executing user account.

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

public virtual IDictionary DetermineUserCapabilities(
	WebPartManager webPartManager


Type: System.Web.UI.WebControls.WebParts.WebPartManager

The WebPartManager managing the personalization information.

Return Value

Type: System.Collections.IDictionary

An IDictionary containing zero or more WebPartUserCapability instances if the user account is authenticated, or null if the executing user account is not authenticated.

Exception Condition

The page associated with webPartManager is null.

- or -

The request associated with the page is null.


webPartManager is null.

The default implementation of this method consumes the information in the authorization Element for personalization for webParts (ASP.NET Settings Schema) element within the personalization Element for webParts (ASP.NET Settings Schema) element of thewebParts Element (ASP.NET Settings Schema) configuration section in the Machine.config or Web.config file to determine a user's authorized capabilities.

The capabilities in the dictionary will be members of the IList object returned by the CreateSupportedUserCapabilities method, which currently include the EnterSharedScopeUserCapability capability and the ModifyStateUserCapability capability.

.NET Framework
Available since 2.0
Return to top