SqlRoleProvider::GetRolesForUser Method (String^)

 

Gets a list of the roles that a user is in.

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

public:
virtual array<String^>^ GetRolesForUser(
	String^ username
) override

Parameters

username
Type: System::String^

The user to return a list of roles for.

Return Value

Type: array<System::String^>^

A string array containing the names of all the roles that the specified user is in.

Exception Condition
System::ArgumentNullException

username is null.

System::ArgumentException

username contains a comma.

-or-

username is longer than 256 characters.

System.Configuration.Provider::ProviderException

An unknown error occurred while communicating with the database.

The GetRolesForUser method is called by the Roles class to retrieve a list of a specified user's roles from the SQL Server database specified in the ASP.NET application's configuration file (Web.config).

The following code example uses the GetRolesForUser method to retrieve a list of roles for a specified user and binds them to a System.Web.UI.WebControls::GridView control. For an example of a Web.config file that enables role management, see SqlRoleProvider.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top
Show: