SqlMembershipProvider Classe

Definizione

Spazio dei nomi:

System.Web.Security

Assembly:

System.Web.dll

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

public ref class SqlMembershipProvider : System::Web::Security::MembershipProvider

public class SqlMembershipProvider : System.Web.Security.MembershipProvider

type SqlMembershipProvider = class
    inherit MembershipProvider

Public Class SqlMembershipProvider
Inherits MembershipProvider

Ereditarietà

Object

ProviderBase

MembershipProvider

SqlMembershipProvider

Esempio

Nell'esempio di codice seguente viene illustrato il file di Web.config per un'applicazione ASP.NET configurata per l'uso di un SqlMembershipProvideroggetto .

<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>  
        <add   
          name="SqlProvider"   
          type="System.Web.Security.SqlMembershipProvider"   
          connectionStringName="SqlServices"  
          applicationName="MyApplication"  
          enablePasswordRetrieval="false"  
          enablePasswordReset="true"  
          requiresQuestionAndAnswer="true"  
          requiresUniqueEmail="false"  
          passwordFormat="Hashed"  
          maxInvalidPasswordAttempts="5"  
          passwordAttemptWindow="10" />  
      </providers>  
    </membership>  
  </system.web>  
</configuration>  

Commenti

Nota

ASP.NET provider di appartenenza sono stati sostituiti da ASP.NET Identity. È consigliabile aggiornare le app per usare la ASP.NET Identity Platform anziché i provider di appartenenza.

Questa classe viene usata dalle Membership classi e MembershipUser per fornire servizi di appartenenza per un'applicazione ASP.NET usando un database SQL Server. Non è possibile usare un SqlMembershipProvider oggetto senza SQL Server. Quando il computer ha SQL Server Express installato con il nome dell'istanza predefinito e l'instancing abilitato per l'utente, l'oggetto SqlMembershipProvider creerà un database denominato aspnetdb nella directory dell'applicazione App_Data la prima volta che l'applicazione viene eseguita.

Per creare manualmente il database, eseguire il Aspnet_regsql.exe file eseguibile trovato nella %systemroot%\Microsoft.NET\Framework\ versionNumber cartella e specificare l'opzione -A m (ad esempio aspnet_regsql.exe -A m). Il database creato è denominato Aspnetdb. In alternativa, eseguire Aspnet_regsql.exe per eseguire il pull della modalità di configurazione gui e scegliere di configurare tutte le funzionalità ASP.NET.

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

Il file Machine.config definisce un'istanza predefinita denominata AspNetSqlMembershipProvider che si connette all'istanza di SQL Server Express predefinita SqlMembershipProvider nel computer locale. È possibile usare questa istanza del provider se è stata installata SQL Server Express con il nome predefinito dell'istanza oppure è possibile definire la propria istanza nel file Web.config per l'applicazione ASP.NET.

Se si imposta l'attributo su Framework40, l'applicazione passwordCompatMode può usare le opzioni di hashing e di appartenenza alla crittografia aggiunte in ASP.NET 4. Tuttavia, se l'attributo passwordCompatMode è impostato su Framework20, è possibile usare solo le opzioni di hashing e di appartenenza alla crittografia dal ASP.NET 2.0, ASP.NET 3.5 e ASP.NET 3.5 SP1. Il valore predefinito è Framework20. Per altre informazioni, vedere MembershipPasswordCompatibilityMode.

Costruttori

SqlMembershipProvider()

Inizializza una nuova istanza della classe SqlMembershipProvider.

Proprietà

ApplicationName	Ottiene o imposta il nome dell'applicazione per cui archiviare e recuperare informazioni di appartenenza.
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)
EnablePasswordReset	Ottiene un valore che indica se il provider di appartenenze di SQL Server è configurato in modo da consentire agli utenti di reimpostare le loro password.
EnablePasswordRetrieval	Ottiene un valore che indica se il provider di appartenenze di SQL Server è configurato in modo da consentire agli utenti di recuperare le loro password.
MaxInvalidPasswordAttempts	Ottiene il numero consentito di tentativi non validi di immissione della password o di risposta alla domanda segreta della password prima che l'utente di appartenenza venga bloccato.
MinRequiredNonAlphanumericCharacters	Ottiene il numero minimo di caratteri speciali che devono essere presenti in una password valida.
MinRequiredPasswordLength	Ottiene la lunghezza minima richiesta per una password.
Name	Ottiene il nome descrittivo utilizzato per fare riferimento al provider durante la configurazione. (Ereditato da ProviderBase)
PasswordAttemptWindow	Ottiene l'intervallo di tempo in cui vengono registrati i tentativi consecutivi non riusciti di fornire una password valida o le risposte per la password.
PasswordFormat	Ottiene un valore che indica il formato di archiviazione delle password nel database di appartenenze di SQL Server.
PasswordStrengthRegularExpression	Ottiene l'espressione regolare usata per valutare una password.
RequiresQuestionAndAnswer	Ottiene un valore che indica se il provider di appartenenze di SQL Server è configurato in modo da richiedere agli utenti di rispondere a una domanda per la password prima di consentire la reimpostazione e il recupero della password.
RequiresUniqueEmail	Ottiene un valore che indica se il provider di appartenenze di SQL Server è configurato in modo da richiedere che per ogni nome utente esista un unico indirizzo di posta elettronica.

Metodi

ChangePassword(String, String, String)	Modifica la password di un utente.
ChangePasswordQuestionAndAnswer(String, String, String, String)	Aggiorna la domanda e la risposta relative alla password di un utente nel database di appartenenze SQL Server.
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	Aggiunge un nuovo utente al database di appartenenze SQL Server.
DecryptPassword(Byte[])	Decrittografa una password crittografata. (Ereditato da MembershipProvider)
DeleteUser(String, Boolean)	Rimuove le informazioni di appartenenza di un utente dal database di appartenenze SQL Server.
EncryptPassword(Byte[])	Crittografa una password. (Ereditato da MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	Crittografa la password specificata utilizzando la modalità di compatibilità della password specificata. (Ereditato da MembershipProvider)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindUsersByEmail(String, Int32, Int32, Int32)	Restituisce una raccolta degli utenti di appartenenza per cui il campo relativo all'indirizzo di posta elettronica contiene l'indirizzo di posta elettronica specificato.
FindUsersByName(String, Int32, Int32, Int32)	Ottiene un insieme degli utenti di appartenenza in cui il nome utente contiene il nome specificato di cui verificare la corrispondenza.
GeneratePassword()	Genera una password casuale lunga almeno 14 caratteri.
GetAllUsers(Int32, Int32, Int32)	Ottiene un insieme di tutti gli utenti nel database di appartenenze SQL Server.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetNumberOfUsersOnline()	Restituisce il numero corrente di utenti connessi all'applicazione.
GetPassword(String, String)	Restituisce la password dell'utente specificato nel database di appartenenze SQL Server.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetUser(Object, Boolean)	Ottiene le informazioni dall'origine dati dell'utente di appartenenza associato all'identificatore univoco specificato e aggiorna l'indicatore di ultima data e ora di attività dell'utente, se è stato indicato.
GetUser(String, Boolean)	Restituisce da un database di appartenenze SQL Server le informazioni di un utente e offre la possibilità di aggiornare l'indicatore di ultima data e ora di attività dell'utente.
GetUserNameByEmail(String)	Ottiene il nome utente associato all'indirizzo di posta elettronica specificato.
Initialize(String, NameValueCollection)	Inizializza il provider di appartenenze 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)
OnValidatingPassword(ValidatePasswordEventArgs)	Genera l'evento ValidatingPassword se è stato definito un gestore eventi. (Ereditato da MembershipProvider)
ResetPassword(String, String)	Reimposta la password di un utente su una nuova password generata automaticamente.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
UnlockUser(String)	Annulla lo stato di blocco dell'utente in modo da consentire la convalida dell'utente di appartenenza.
UpdateUser(MembershipUser)	Aggiorna le informazioni riguardanti un utente nel database di appartenenze SQL Server.
ValidateUser(String, String)	Verifica che nome utente e password specificati esistano nel database di appartenenze SQL Server.

Eventi

ValidatingPassword

Si verifica quando viene creato un utente, viene modificata una password o viene reimpostata una password. (Ereditato da MembershipProvider)

Vedi anche

• Introduzione all'appartenenza a ASP.NET