SqlMembershipProvider Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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::MembershipProviderpublic class SqlMembershipProvider : System.Web.Security.MembershipProvidertype SqlMembershipProvider = class
inherit MembershipProviderPublic Class SqlMembershipProvider
Inherits MembershipProvider- Ereditarietà
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 di SQL Server. Non è possibile usare un SqlMembershipProvider oggetto senza SQL Server. Quando il computer dispone di 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 viene eseguita l'applicazione.
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 ASP.NET deve avere diritti per connettersi al database di SQL Server.
Il file Machine.config definisce un'istanza predefinita denominata AspNetSqlMembershipProvider che si connette all'istanza predefinita SqlMembershipProvider di SQL Server Express nel computer locale. È possibile usare questa istanza del provider se è stato installato SQL Server Express con il nome dell'istanza predefinito 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) |
