Roles.Providers Proprietà

Definizione

Ottiene una raccolta dei provider di ruoli per l'applicazione ASP.NET.

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

Valore della proprietà

Oggetto RoleProviderCollection contenente i provider di ruoli configurati per l'applicazione ASP.NET.

Eccezioni

La gestione ruoli non è attivata.

Esempio

Nell'esempio di codice seguente vengono elencati i provider abilitati per un'applicazione e i rispettivi tipi.

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

Commenti

La Providers proprietà fa riferimento a tutti i provider di ruoli abilitati per un'applicazione, inclusi i provider aggiunti nel file Web.config. È possibile controllare quali provider di ruoli sono disponibili per un'applicazione usando l'elemento providers della sezione roleManager nel file Web.config per l'applicazione.

Nell'esempio seguente viene illustrata una sezione roleManager che rimuove tutti i provider esistenti , ad esempio quelli specificati nel file Machine.config, e aggiunge un'istanza SqlRoleProvider come provider di ruoli per l'applicazione.

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

È possibile ottenere un riferimento fortemente tipizzato a un provider dalla Providers raccolta indicizzando il provider di ruoli in base al nome e eseguendo il cast come tipo desiderato.

È possibile ottenere un riferimento al provider predefinito per un'applicazione usando la Provider proprietà .

Si applica a

Vedi anche