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

Articolo
09/12/2008

Aggiornamento: novembre 2007

Aggiunge un'istanza del provider di ruoli all'insieme di provider di 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)
      Elemento providers per roleManager (schema delle impostazioni ASP.NET)
        Elemento add per providers per roleManager (schema delle impostazioni ASP.NET)

<add name="provider name" 
     type="string"
     connectionStringName="string"
     applicationName="string" 
     commandTimeout="number" 
     description="string" 
     cacheRefreshInterval="number" 
     scopeName="string"/>

Attributi ed elementi

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

Attributi

Attributo	Descrizione
applicationName	Attributo String facoltativo. Specifica il nome dell'applicazione in cui vengono archiviati i nomi dei ruoli nell'origine dati. Il nome dell'applicazione consente a più applicazioni ASP.NET di utilizzare lo stesso database senza che vengano rilevati nomi di ruoli duplicati per applicazioni diverse. In alternativa, più applicazioni ASP.NET possono utilizzare le stesse informazioni del ruolo specificando lo stesso nome di applicazione. I provider di ruoli inclusi in .NET Framework utilizzano il valore ApplicationVirtualPath per la proprietà ApplicationName, se tale attributo non è specificato.
cacheRefreshInterval	Attributo Int32 facoltativo. Specifica il numero di minuti che intercorrono tra gli aggiornamenti imposti dei dati dell'archivio di criteri memorizzati nella cache ed è applicabile solo a AuthorizationStoreRoleProvider. Il valore predefinito è 60.
commandTimeout	Attributo Int32 facoltativo. Specifica il numero di secondi che trascorrono prima del timeout di un comando rilasciato all'origine dati relativa a Gestione ruoli. Questo valore di timeout viene utilizzato dal provider SQL durante la creazione di oggetti SqlCommand. Per impostazione predefinita, l'attributo non viene impostato nella configurazione ASP.NET. Viene quindi utilizzato il valore ADO.NET predefinito di 30 secondi. Se questo attributo è impostato, il provider SQL utilizza il valore di timeout configurato per tutti i comandi SQL inviati al database. Il valore predefinito è 30 (il valore ADO.NET predefinito).
connectionStringName	Attributo String obbligatorio. Specifica il nome della stringa di connessione definita nell'elemento <connectionStrings>. La stringa di connessione specificata verrà utilizzata dal provider aggiunto.
description	Attributo String facoltativo. Specifica una descrizione dell'istanza del provider di ruoli.
name	Attributo String obbligatorio. Specifica il nome dell'istanza del provider. Si tratta del valore utilizzato per l'attributo defaultProvider dell'elemento <roleManager> che consente di identificare l'istanza del provider come provider di ruoli predefinito. L'attributo name del provider viene inoltre utilizzato per indicizzare il provider nell'insieme Providers.
scopeName	Attributo String facoltativo. Specifica l'ambito di protezione di un archivio di criteri di Gestione autorizzazioni a cui si deve collegare l'istanza del provider ed è applicabile solo a AuthorizationStoreRoleProvider. Se è specificato scopeName, il provider utilizza la combinazione di applicationName e scopeName per la connessione all'archivio di criteri.
type	Attributo String obbligatorio. Specifica il tipo che implementa la classe base astratta RoleProvider.

Elementi figlio

Nessuno.

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.
roleManager	Configura un'applicazione per la gestione dei ruoli.
providers	Definisce un insieme di provider di ruoli per la gestione dei ruoli.

Note

L'elemento add aggiunge un'istanza del provider dei ruoli all'insieme di provider di gestione memorizzato nell'elemento providers.

L'elemento providers consente di definire un insieme di provider di ruoli 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, WindowsTokenRoleProvider, SqlRoleProvider e AuthorizationStoreRoleProvider.

Configurazione predefinita

Nel file Machine.config viene configurato l'elemento providers predefinito seguente:

<roleManager>
   <providers>
<add name="AspNetSqlRoleProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
        <add name="AspNetWindowsTokenRoleProvider" applicationName="/" 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	Add
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 add per providers per 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