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 sui profili e i valori delle proprietà vengono gestiti usando 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 SQL Server. Per usare un SqlProfileProvideroggetto , è prima necessario creare il database SQL Server utilizzato da SqlProfileProvider. Per creare il database usato da SqlProfileProvider, eseguire lo strumento aspnet_regsql.exe, disponibile nella cartella [drive:]\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 al 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.

Nota

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

Costruttori

SqlProfileProvider()

Crea un'istanza della classe SqlProfileProvider.

Proprietà

ApplicationName	Ottiene o imposta il nome dell'applicazione per cui archiviare o recuperare informazioni sul profilo.
Description	Ottiene una breve descrizione di facile comprensione che è possibile visualizzare in strumenti di amministrazione o in altre interfacce utente (UI, User Interface). (Ereditato da ProviderBase)
Name	Ottiene il nome descrittivo utilizzato per fare riferimento al provider durante la configurazione. (Ereditato da ProviderBase)

Metodi

DeleteInactiveProfiles(ProfileAuthenticationOption, DateTime)	Elimina i dati dei profili utente in cui la data dell'ultima attività è precedente alla data e all'ora specificate.
DeleteProfiles(ProfileInfoCollection)	Elimina dall'origine dati le informazioni e le proprietà dei profili specificati nell'elenco fornito.
DeleteProfiles(String[])	Elimina dall'origine dati le informazioni e le proprietà dei profili relativi ai nomi utente specificati nell'elenco fornito.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindInactiveProfilesByUserName(ProfileAuthenticationOption, String, DateTime, Int32, Int32, Int32)	Recupera le informazioni sui profili in cui la data dell'ultima attività corrisponde o è precedente alla data e all'ora specificate e in cui il nome utente del profilo corrisponde al nome specificato.
FindProfilesByUserName(ProfileAuthenticationOption, String, Int32, Int32, Int32)	Recupera le informazioni sui profili in cui il nome utente corrisponde al nome specificato.
GetAllInactiveProfiles(ProfileAuthenticationOption, DateTime, Int32, Int32, Int32)	Recupera i dati dei profili utente in cui la data dell'ultima attività corrisponde o è precedente alla data e all'ora specificate.
GetAllProfiles(ProfileAuthenticationOption, Int32, Int32, Int32)	Recupera i dati dei profili utente presenti nell'origine dati.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetNumberOfInactiveProfiles(ProfileAuthenticationOption, DateTime)	Ottiene il numero di profili presenti nell'origine dati per cui la data dell'ultima attività corrisponde o è precedente al valore del parametro userInactiveSinceDate specificato.
GetPropertyValues(SettingsContext, SettingsPropertyCollection)	Recupera le informazioni e i valori delle proprietà del profilo da un database di profili di SQL Server.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Initialize(String, NameValueCollection)	Inizializza il provider di profili 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 dell'oggetto Object corrente. (Ereditato da Object)
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)	Aggiorna il database di profili di SQL Server in base ai 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