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

Articolo
08/11/2011

Aggiunge un'istanza di provider di profili all'insieme di provider di profili utente.

Questo elemento è nuovo in .NET Framework versione 2.0.

<add 
    name="provider name" 
    type="fully qualified type reference"
    connectionStringName="connection string identifier"
    commandTimeout="number of seconds before a command times out"
    description="description of the provider instance"
    applicationName="application name for stored profile information" />

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attribute	Descrizione
name	Attributo String obbligatorio. Specifica il nome dell'istanza del provider. Si tratta del valore utilizzato per l'attributo defaultProvider dell'elemento <profile> che consente di identificare l'istanza del provider come provider di profilo predefinito. L'attributo name del provider viene inoltre utilizzato per indicizzare il provider nell'insieme Providers.
type	Attributo String obbligatorio. Specifica il tipo che implementa la classe base astratta ProfileProvider.
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.
applicationName	Attributo String facoltativo. Specifica il nome dell'applicazione in cui vengono archiviati i dati sul profilo nell'origine dati. Il nome dell'applicazione consente a più applicazioni ASP.NET di utilizzare lo stesso database senza che vengano rilevati dati di profili duplicati per applicazioni diverse. In alternativa, più applicazioni ASP.NET possono utilizzare le stesse informazioni del profilo specificando lo stesso nome di applicazione. I provider di profili inclusi in .NET Framework utilizzano il valore ApplicationVirtualPath per la proprietà ApplicationName, se tale attributo non è specificato.
commandTimeout	Attributo Int32 facoltativo. Specifica il numero di secondi che trascorrono prima del timeout di un comando rilasciato all'origine dati relativi all'appartenenza. 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, pertanto, 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).
description	Attributo String facoltativo. Specifica una descrizione dell'istanza del provider di profili.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
providers	Definisce un insieme di provider di profili per il profilo utente.
profile	Configura il profilo utente per un'applicazione.
configuration	Specifica l'elemento di primo livello 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

Per implementare un provider di profili personalizzato, è possibile includere altri attributi nell'elemento add. Per un esempio, vedere Procedura: compilare ed eseguire l'esempio di provider di profili.

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

Configurazione predefinita

Nel file Machine.config in .NET Framework versione 2.0 viene configurato l'elemento profile predefinito riportato di seguito.

  <providers>
    <add name="AspNetSqlProfileProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Profile.SqlProfileProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> 
  </providers>

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come creare un file Web.config per un'applicazione ASP.NET configurata per l'utilizzo di un provider SqlProfileProvider.

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

  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="login.aspx" name=".ASPXFORMSAUTH" />
    </authentication>

    <authorization>
      <deny users="?" />
    </authorization>

    <membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="15">
      <providers>
        <clear/>
        <add name="SqlProvider" 
             type="System.Web.Security.SqlMembershipProvider" 
             connectionStringName="SqlServices"
             applicationName="SampleApplication"
             enablePasswordRetrieval="true"
             enablePasswordReset="true"
             passwordFormat="Encrypted"
             requiresQuestionAndAnswer="true" />
      </providers>
    </membership>

    <profile defaultProvider="SqlProvider">
      <providers>
        <clear />
        <add name="SqlProvider"
             type="System.Web.Profile.SqlProfileProvider"
             connectionStringName="SqlServices"
             applicationName="SampleApplication"
             description="SqlProfileProvider for SampleApplication" />
      </providers>

      <properties>
        <add name="ZipCode" />
        <add name="CityAndState" />
      </properties>
    </profile>
  </system.web>
</configuration>

Informazioni sull'elemento

Gestore della sezione di configurazione	System.Web.Configuration.ProfileSection
Membro di configurazione	ProfileSection.Providers
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 2005

Vedere anche

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

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Note

Configurazione predefinita

Esempio

Informazioni sull'elemento

Vedere anche

Attività

Riferimenti

Concetti

Altre risorse

Risorse aggiuntive