Elemento roleManager (schema delle impostazioni ASP.NET)

Articolo
09/12/2008

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.

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

Condividi tramite

Elemento roleManager (schema delle impostazioni ASP.NET)

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Note

Configurazione predefinita

Esempio

Informazioni sull'elemento

Vedere anche

Attività

Concetti

Riferimenti

Altre risorse

Risorse aggiuntive