RoleProviderCollection Class
A collection of objects that inherit the RoleProvider abstract class.
System.Configuration.Provider.ProviderCollection
System.Web.Security.RoleProviderCollection
Namespace: System.Web.Security
Assembly: System.Web (in System.Web.dll)
The RoleProviderCollection type exposes the following members.
| Name | Description | |
|---|---|---|
 | Count | Gets the number of providers in the collection. (Inherited from ProviderCollection.) |
| IsSynchronized | Gets a value indicating whether access to the collection is synchronized (thread safe). (Inherited from ProviderCollection.) |
| Item | Gets the role provider in the collection referenced by the specified provider name. |
| SyncRoot | Gets the current object. (Inherited from ProviderCollection.) |
| Name | Description | |
|---|---|---|
| Add | Adds a role provider to the collection. (Overrides ProviderCollection.Add(ProviderBase).) |
| Clear | Removes all items from the collection. (Inherited from ProviderCollection.) |
| CopyTo(ProviderBase[], Int32) | Copies the contents of the collection to the given array starting at the specified index. (Inherited from ProviderCollection.) |
| CopyTo(RoleProvider[], Int32) | Copies the role provider collection to a one-dimensional array. |
| Equals(Object) | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
| GetEnumerator | Returns an object that implements the IEnumerator interface to iterate through the collection. (Inherited from ProviderCollection.) |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| Remove | Removes a provider from the collection. (Inherited from ProviderCollection.) |
| SetReadOnly | Sets the collection to be read-only. (Inherited from ProviderCollection.) |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
| Name | Description | |
|---|---|---|
| ICollection.CopyTo | Copies the elements of the ProviderCollection to an array, starting at a particular array index. (Inherited from ProviderCollection.) |
The role providers for an application are exposed as a read-only RoleProviderCollection by the Providers property of the Roles class. You can access a specific role provider in the collection by name and cast it as the specific provider type, such as SqlRoleProvider. This enables you to manage role information from multiple data stores in a single application as well as access custom members of a role provider that are not part of the RoleProvider abstract class.
The following code example lists the providers enabled for an application and their respective types.
<%@ Page Language="C#" %> <%@ Import Namespace="System.Web.Security" %> <%@ Import Namespace="System.Configuration.Provider" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" > <head> <title>List Enabled Providers</title> </head> <body> <% foreach (RoleProvider p in Roles.Providers) Response.Write(p.Name + ", " + p.GetType() + "<br />"); %> </body> </html>
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
