Condividi tramite


Elemento roleManager (schema delle impostazioni ASP.NET)

Aggiornamento: novembre 2007

Configura un'applicazione per la gestione dei ruoli.

Questo elemento è nuovo in .NET Framework versione 2.0.

Elemento configuration (schema delle impostazioni generali)
  Elemento system.web (schema delle impostazioni ASP.NET)
    Elemento roleManager (schema delle impostazioni ASP.NET)

<roleManager
    cacheRolesInCookie="true|false"
    cookieName="name"
    cookiePath="/"
    cookieProtection="All|Encryption|Validation|None"
    cookieRequireSSL="true|false "
    cookieSlidingExpiration="true|false "
    cookieTimeout="number of minutes"
    createPersistentCookie="true|false"
    defaultProvider="provider name"
    domain="cookie domain">
    enabled="true|false"
    maxCachedResults="maximum number of role names cached"
    <providers>...</providers>
</roleManager>

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed elementi padre per questa sezione.

Attributi

Attributo

Descrizione

cacheRolesInCookie

Attributo Boolean facoltativo.

Specifica che quando si accerta che un utente è in un determinato ruolo, il cookie viene controllato prima di utilizzare il provider di ruoli per verificare l'elenco di ruoli nell'origine dati. Se l'impostazione è true, un elenco di nomi di ruoli in un cookie dell'utente corrente è memorizzato nella cache. In caso contrario, l'impostazione sarà false.

Il valore predefinito è false.

cookieName

Attributo String facoltativo.

Specifica il nome del cookie in cui vengono archiviati i nomi dei ruoli.

Il valore predefinito è ".ASPXROLES".

cookiePath

Attributo String facoltativo.

Percorso del cookie contenente i nomi dei ruoli.

Il valore predefinito è "/".

cookieProtection

Attributo CookieProtection facoltativo.

Specifica uno dei valori di enumerazione di CookieProtection.

Il valore predefinito è All.

cookieRequireSSL

Attributo Boolean facoltativo.

Specifica se per inviare al server il cookie con i nomi dei ruoli è necessario SSL.

Se è impostato su true, per inviare al server i cookie con i nomi dei ruoli è necessario SSL.

Il valore predefinito è false.

cookieSlidingExpiration

Attributo Boolean facoltativo.

Specifica se l'ora e la data di scadenza del cookie con i nomi dei ruoli verranno reimpostate periodicamente.

Se è impostato su true, la scadenza del cookie verrà inizialmente impostata sull'ora e sulla data correnti a cui viene aggiunto il valore di CookieTimeout espresso in minuti. Mentre l'utente continua a utilizzare attivamente l'applicazione ASP.NET, la data e l'ora di scadenza del cookie verranno automaticamente aggiornate, se rimane meno di metà del valore espresso da CookieTimeout. Per ulteriori informazioni, vedere Expires.

Il valore predefinito è true.

cookieTimeout

Attributo Int32 facoltativo.

Numero di minuti prima della scadenza del cookie contenente i nomi dei ruoli.

Il valore predefinito è "30" (minuti).

createPersistentCookie

Attributo Boolean facoltativo.

Specifica se il cookie con i nomi dei ruoli è un cookie di sessione, ovvero viene eliminato alla chiusura del browser.

Se è impostato su true, il cookie con i nomi dei ruoli è permanente, ovvero è disponibile in più sessioni del browser. La data e l'ora di scadenza del cookie permanente vengono impostate sulla data e l'ora correnti a cui viene aggiunto il valore di CookieTimeout espresso in minuti.

Il valore predefinito è false.

defaultProvider

Attributo String facoltativo.

Nome del provider di ruoli predefinito. Per ulteriori informazioni, vedere Provider.

Il valore predefinito è "AspNetSqlRoleProvider".

domain

Attributo String facoltativo.

Specifica il valore Domain del cookie contenente i nomi dei ruoli.

Il valore predefinito è il valore predefinito della proprietà HttpCookie, ovvero una stringa vuota ("").

enabled

Attributo Boolean facoltativo.

Specifica se attivare la gestione dei ruoli.

Quando è impostato su true, la gestione dei ruoli è attivata.

Il valore predefinito è false nel file Machine.config.

maxCachedResults

Attributo Int32 facoltativo.

Specifica il numero massimo di nomi di ruoli memorizzati nella cache del cookie dei ruoli.

Il valore predefinito è 25.

Attributi ereditati

Attributi facoltativi.

Attributi ereditati da tutti gli elementi section. Per ulteriori informazioni, vedere Attributi generali ereditati da elementi di sezioni.

Elementi figlio

Elemento

Descrizione

providers

Elemento facoltativo.

Consente di definire un insieme di provider di ruoli per la gestione dei ruoli.

Elementi padre

Elemento

Descrizione

configuration

Specifica l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

system.web

Specifica l'elemento di primo livello per la sezione di configurazione ASP.NET.

Note

L'elemento roleManager configura un'applicazione per la gestione dei ruoli.

Per informazioni su come accedere ai valori di configurazione per l'elemento roleManager e modificarli nel codice dell'applicazione, vedere RoleManagerSection.

Configurazione predefinita

L'elemento roleManager predefinito riportato di seguito non viene configurato in modo esplicito nel file Machine.config o nel file Web.config principale. Si tratta, tuttavia, della configurazione predefinita restituita dall'applicazione. I provider vengono configurati in modo esplicito nel file Machine.config.

<roleManager 
   enabled="false" 
   cacheRolesInCookie="false" 
   cookieName=".ASPXROLES" 
   cookieTimeout="30" 
   cookiePath="/" 
   cookieRequireSSL="false" 
   cookieSlidingExpiration="true" 
   cookieProtection="All" 
   defaultProvider="AspNetSqlRoleProvider" 
   createPersistentCookie="false" 
   maxCachedResults="25">
   <providers>
      <clear />
      <add 
         connectionStringName="LocalSqlServer" 
         applicationName="/" 
         name="AspNetSqlRoleProvider" 
         type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
      <add 
         applicationName="/" 
         name="AspNetWindowsTokenRoleProvider" 
         type="System.Web.Security.WindowsTokenRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
   </providers>
</roleManager>

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come configurare un'applicazione ASP.NET per l'utilizzo della classe SqlRoleProvider per la memorizzazione e il recupero di informazioni sui ruoli.

<configuration>
  <system.web>
    <roleManager defaultProvider="SqlProvider" 
      enabled="true"
      cacheRolesInCookie="true"
      cookieName=".ASPROLES"
      cookieTimeout="30"
      cookiePath="/"
      cookieRequireSSL="false"
      cookieSlidingExpiration="true"
      cookieProtection="All" >
      <providers>
        <add
          name="SqlProvider"
          type="System.Web.Security.SqlRoleProvider"
          connectionStringName="SqlServices" 
          applicationName="SampleApplication" />
      </providers>
    </roleManager>
  </system.web>
</configuration>

Informazioni sull'elemento

Gestore della sezione di configurazione

RoleManagerSection

Membro di configurazione

RoleManager

Percorsi configurabili

Machine.config

Web.config a livello di radice

Web.config a livello di applicazione

Requisiti

Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0

.NET Framework versione 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Attività

Procedura: configurare directory specifiche utilizzando le impostazioni posizione

Procedura: bloccare le impostazioni di configurazione di ASP.NET

Concetti

Informazioni sulla gestione dei ruoli

Protezione della configurazione di ASP.NET

Scenari di configurazione ASP.NET

Riferimenti

Elemento system.web (schema delle impostazioni ASP.NET)

Elemento providers per roleManager (schema delle impostazioni ASP.NET)

Elemento configuration (schema delle impostazioni generali)

System.Configuration

System.Web.Configuration

RoleManagerSection

RoleManager

Altre risorse

Impostazioni di configurazione generali (ASP.NET)

Impostazioni di configurazione di ASP.NET

Riferimento ASP.NET

Amministrazione di siti Web ASP.NET

API di configurazione di ASP.NET