SqlProfileProvider Classe

Definizione

Spazio dei nomi:

System.Web.Profile

Assembly:

System.Web.dll

Gestisce l'archiviazione delle informazioni sul profilo per un'applicazione ASP.NET in un database di SQL Server.

public ref class SqlProfileProvider : System::Web::Profile::ProfileProvider

public class SqlProfileProvider : System.Web.Profile.ProfileProvider

type SqlProfileProvider = class
    inherit ProfileProvider

Public Class SqlProfileProvider
Inherits ProfileProvider

Ereditarietà

Object

ProviderBase

SettingsProvider

ProfileProvider

SqlProfileProvider

Esempio

Nell'esempio di codice seguente viene illustrato il file Web.config per un'applicazione ASP.NET configurata per l'uso di .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>

Commenti

Il profilo ASP.NET viene usato per archiviare e recuperare le impostazioni utente in un'origine dati, ad esempio un database. L'accesso al profilo utente viene eseguito usando la Profile proprietà dell'oggetto corrente HttpContext. Le informazioni sul profilo e i valori delle proprietà vengono gestiti tramite un provider di profili.

La SqlProfileProvider classe viene usata da ASP.NET per archiviare e recuperare le impostazioni del profilo per un'applicazione ASP.NET che usa un database di SQL Server. Per usare un SqlProfileProvideroggetto , è prima necessario creare il database di SQL Server usato da SqlProfileProvider. Per creare il database usato da SqlProfileProvider, eseguire lo strumento aspnet_regsql.exe, disponibile nella cartella [unità:]\WINDOWS\Microsoft.NET\Framework\2.0versionNumber e specificare l'opzione -A p . Il comando seguente illustra come usare l'eseguibile aspnet_regsql.exe:

aspnet_regsql.exe -A p

Nell'esempio precedente non viene specificato un nome per il database creato, quindi verrà usato il nome predefinito. Il nome predefinito del database è Aspnetdb.

La configurazione del computer contiene un'istanza predefinita denominata SqlProfileProvider AspNetSqlProvider che si connette a SQL Server nel computer locale. È possibile usare questa istanza del provider o specificare il proprio nel file di Web.config per l'applicazione ASP.NET.

Annotazioni

Se il provider di profili è configurato con una stringa di connessione che usa la sicurezza integrata, l'account di processo dell'applicazione ASP.NET deve disporre dei diritti per connettersi al database di SQL Server.

Costruttori

Nome	Descrizione
SqlProfileProvider()	Crea un'istanza della classe SqlProfileProvider.

Proprietà

Nome	Descrizione
ApplicationName	Ottiene o imposta il nome dell'applicazione per cui archiviare e recuperare le informazioni sul profilo.
Description	Ottiene una breve descrizione descrittiva adatta per la visualizzazione negli strumenti di amministrazione o in altre interfacce utente. (Ereditato da ProviderBase)
Name	Ottiene il nome descrittivo utilizzato per fare riferimento al provider durante la configurazione. (Ereditato da ProviderBase)

Metodi

Nome	Descrizione
DeleteInactiveProfiles(ProfileAuthenticationOption, DateTime)	Elimina i dati del profilo utente per i profili in cui si è verificata l'ultima data dell'attività prima della data e dell'ora specificate.
DeleteProfiles(ProfileInfoCollection)	Elimina le proprietà e le informazioni del profilo per l'elenco di profili fornito dall'origine dati.
DeleteProfiles(String[])	Elimina le proprietà e le informazioni del profilo dall'origine dati per l'elenco fornito di nomi utente.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindInactiveProfilesByUserName(ProfileAuthenticationOption, String, DateTime, Int32, Int32, Int32)	Recupera le informazioni sul profilo per i profili in cui si è verificata l'ultima data dell'attività in o prima della data e dell'ora specificate e il nome utente per il profilo corrisponde al nome specificato.
FindProfilesByUserName(ProfileAuthenticationOption, String, Int32, Int32, Int32)	Recupera le informazioni sul profilo per i profili in cui il nome utente corrisponde al nome specificato.
GetAllInactiveProfiles(ProfileAuthenticationOption, DateTime, Int32, Int32, Int32)	Recupera i dati del profilo utente per i profili in cui si è verificata l'ultima data dell'attività in o prima della data e dell'ora specificate.
GetAllProfiles(ProfileAuthenticationOption, Int32, Int32, Int32)	Recupera i dati del profilo utente per i profili nell'origine dati.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetNumberOfInactiveProfiles(ProfileAuthenticationOption, DateTime)	Ottiene il numero di profili nell'origine dati in cui si è verificata l'ultima data dell'attività in o prima dell'oggetto specificato userInactiveSinceDate.
GetPropertyValues(SettingsContext, SettingsPropertyCollection)	Recupera le informazioni sulle proprietà del profilo e i valori da un database del profilo di SQL Server.
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Initialize(String, NameValueCollection)	Inizializza il provider del profilo di SQL Server con i valori delle proprietà specificati nel file di configurazione dell'applicazione ASP.NET. Questo metodo non deve essere usato direttamente dal codice.
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)	Aggiorna il database del profilo di SQL Server con i valori delle proprietà specificati.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• Panoramica delle proprietà del profilo ASP.NET