Roles.Providers Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.Security
Ensamblado:
System.Web.dll

Obtiene una colección de los proveedores de roles de la aplicación ASP.NET.

public:
 static property System::Web::Security::RoleProviderCollection ^ Providers { System::Web::Security::RoleProviderCollection ^ get(); };
public static System.Web.Security.RoleProviderCollection Providers { get; }
member this.Providers : System.Web.Security.RoleProviderCollection
Public Shared ReadOnly Property Providers As RoleProviderCollection

Valor de propiedad

RoleProviderCollection

Una clase RoleProviderCollection que contiene los proveedores de roles configurados para la aplicación ASP.NET.

Excepciones

ProviderException

No está habilitada la administración de roles.

Ejemplos

En el ejemplo de código siguiente se enumeran los proveedores habilitados para una aplicación y sus respectivos tipos.

<%@ 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>

<%@ Page Language="VB" %>
<%@ 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>

<%
For Each p As RoleProvider In Roles.Providers
  Response.Write(p.Name & ", " & p.GetType().ToString() & "<br />")
Next
%>

</body>
</html>

Comentarios

La Providers propiedad hace referencia a todos los proveedores de roles habilitados para una aplicación, incluidos los proveedores agregados en el archivo Web.config. Puede controlar qué proveedores de roles están disponibles para una aplicación mediante el providers elemento de la sección roleManager del archivo Web.config de la aplicación.

En el ejemplo siguiente se muestra una sección roleManager que quita los proveedores existentes (como los especificados en el archivo Machine.config) y agrega una SqlRoleProvider instancia como proveedor de roles para la aplicación.

<configuration>
  <connectionStrings>
    <add name="SqlServices" connectionString="Data Source=MySqlServer;Integrated Security=SSPI;Initial Catalog=aspnetdb;" />
  </connectionStrings>

  <system.web>
    <roleManager defaultProvider="SqlProvider"
      enabled="true"
      cacheRolesInCookie="true"
      cookieName=".ASPROLES"
      cookieTimeout="30"
      cookiePath="/"
      cookieRequireSSL="false"
      cookieSlidingExpiration="true"
      cookieProtection="Encrypted">

      <providers>
        <clear/>
        <add
          name="SqlProvider"
          type="System.Web.Security.SqlRoleProvider"
          connectionStringName="SqlServices"
          applicationName="MyApplication" />
         </providers>

    </roleManager>
  </system.web>
</configuration>

Puede obtener una referencia fuertemente tipada a un proveedor de la Providers colección indizar el proveedor de roles por nombre y convertirlo como el tipo deseado.

Puede obtener una referencia al proveedor predeterminado de una aplicación mediante la Provider propiedad .

Se aplica a

Consulte también