SqlMembershipProvider Classe

Definizione

Gestisce l'archiviazione delle informazioni di appartenenza per un'applicazione ASP.NET in un database di SQL Server.Manages storage of membership information for an ASP.NET application in a SQL Server database.

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à
SqlMembershipProvider

Esempio

Nell'esempio di codice seguente viene illustrato il file di Web.config per un'applicazione ASP.NET configurata per l'utilizzo di SqlMembershipProvider .The following code example shows the Web.config file for an ASP.NET application configured to use a SqlMembershipProvider.

<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

Questa classe viene utilizzata dalle Membership classi e MembershipUser per fornire servizi di appartenenza per un'applicazione ASP.NET utilizzando un database SQL Server.This class is used by the Membership and MembershipUser classes to provide membership services for an ASP.NET application using a SQL Server database. Non è possibile usare un SqlMembershipProvider senza SQL Server.You cannot use a SqlMembershipProvider without SQL Server. Quando nel computer è installato SQL Server Express con il nome dell'istanza predefinita e la creazione di istanze utente abilitata, l' SqlMembershipProvider oggetto creerà un database denominato aspnetdb nella App_Data directory dell'applicazione la prima volta che l'applicazione viene eseguita.When your computer has SQL Server Express installed with the default instance name and user-instancing enabled, the SqlMembershipProvider object will create a database called aspnetdb in the application's App_Data directory the first time the application is run.

Per creare manualmente il database, eseguire il Aspnet_regsql.exe file eseguibile trovato nella %systemroot%\Microsoft.NET\Framework\ versionNumber cartella e specificare l' -A m opzione (ad esempio aspnet_regsql.exe -A m ).To manually create the database, run the Aspnet_regsql.exe executable found in the %systemroot%\Microsoft.NET\Framework\ versionNumber folder and specify the -A m option (for example aspnet_regsql.exe -A m). Il database creato è denominato aspnetdb.The database created is called Aspnetdb. In alternativa, eseguire Aspnet_regsql.exe per estrarre la modalità di configurazione GUI e scegliere di configurare tutte le funzionalità ASP.NET.Alternatively, run Aspnet_regsql.exe to pull up the GUI configuration mode and choose to configure all ASP.NET Features.

Se il provider di appartenenze è configurato con una stringa di connessione che usa la sicurezza integrata, l'account del processo dell'applicazione ASP.NET deve disporre dei diritti per la connessione al database SQL Server.If the membership provider is configured with a connection string that uses integrated security, the process account of the ASP.NET application must have rights to connect to the SQL Server database.

Il file di Machine.config definisce un' SqlMembershipProvider istanza predefinita denominata AspNetSqlMembershipProvider che si connette all'istanza predefinita di SQL Server Express nel computer locale.The Machine.config file defines a default SqlMembershipProvider instance named AspNetSqlMembershipProvider that connects to the default SQL Server Express instance on the local machine. È possibile utilizzare questa istanza del provider se è stato installato SQL Server Express con il nome dell'istanza predefinita oppure è possibile definire un'istanza personalizzata nel file Web.config per l'applicazione ASP.NET.You can use this instance of the provider if you installed SQL Server Express with the default instance name, or you can define your own instance in the Web.config file for your ASP.NET application.

Se si imposta l' passwordCompatMode attributo su Framework40 , l'applicazione può utilizzare le opzioni di appartenenza hash e crittografia aggiunte in ASP.NET 4.If you set the passwordCompatMode attribute to Framework40, the application can use the hashing and encryption membership options that were added in ASP.NET 4. Tuttavia, se l' passwordCompatMode attributo è impostato su Framework20 , è possibile utilizzare solo le opzioni di appartenenza hash e crittografia da ASP.NET 2,0, ASP.NET 3,5 e ASP.NET 3,5 SP1.However, if the passwordCompatMode attribute is set to Framework20, only the hashing and encryption membership options from the ASP.NET 2.0, ASP.NET 3.5, and ASP.NET 3.5 SP1 can be used. Il valore predefinito è Framework20.The default value is Framework20. Per altre informazioni, vedere MembershipPasswordCompatibilityMode.For more information, see MembershipPasswordCompatibilityMode.

Costruttori

SqlMembershipProvider()

Inizializza una nuova istanza della classe SqlMembershipProvider.Initializes a new instance of the SqlMembershipProvider class.

Proprietà

ApplicationName

Ottiene o imposta il nome dell'applicazione per cui archiviare e recuperare informazioni di appartenenza.Gets or sets the name of the application to store and retrieve membership information for.

Description

Ottiene una breve descrizione di facile comprensione che è possibile visualizzare in strumenti di amministrazione o in altre interfacce utente (UI, User Interface).Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(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.Gets a value indicating whether the SQL Server membership provider is configured to allow users to reset their passwords.

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.Gets a value indicating whether the SQL Server membership provider is configured to allow users to retrieve their passwords.

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.Gets the number of invalid password or password-answer attempts allowed before the membership user is locked out.

MinRequiredNonAlphanumericCharacters

Ottiene il numero minimo di caratteri speciali che devono essere presenti in una password valida.Gets the minimum number of special characters that must be present in a valid password.

MinRequiredPasswordLength

Ottiene la lunghezza minima richiesta per una password.Gets the minimum length required for a password.

Name

Ottiene il nome descrittivo utilizzato per fare riferimento al provider durante la configurazione.Gets the friendly name used to refer to the provider during configuration.

(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.Gets the time window between which consecutive failed attempts to provide a valid password or password answers are tracked.

PasswordFormat

Ottiene un valore che indica il formato di archiviazione delle password nel database di appartenenze di SQL Server.Gets a value indicating the format for storing passwords in the SQL Server membership database.

PasswordStrengthRegularExpression

Ottiene l'espressione regolare usata per valutare una password.Gets the regular expression used to evaluate a 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.Gets a value indicating whether the SQL Server membership provider is configured to require the user to answer a password question for password reset and retrieval.

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.Gets a value indicating whether the SQL Server membership provider is configured to require a unique email address for each user name.

Metodi

ChangePassword(String, String, String)

Modifica la password di un utente.Modifies a user's password.

ChangePasswordQuestionAndAnswer(String, String, String, String)

Aggiorna la domanda e la risposta relative alla password di un utente nel database di appartenenze SQL Server.Updates the password question and answer for a user in the SQL Server membership database.

CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)

Aggiunge un nuovo utente al database di appartenenze SQL Server.Adds a new user to the SQL Server membership database.

DecryptPassword(Byte[])

Decrittografa una password crittografata.Decrypts an encrypted password.

(Ereditato da MembershipProvider)
DeleteUser(String, Boolean)

Rimuove le informazioni di appartenenza di un utente dal database di appartenenze SQL Server.Removes a user's membership information from the SQL Server membership database.

EncryptPassword(Byte[])

Crittografa una password.Encrypts a password.

(Ereditato da MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)

Crittografa la password specificata utilizzando la modalità di compatibilità della password specificata.Encrypts the specified password using the specified password-compatibility mode.

(Ereditato da MembershipProvider)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(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.Returns a collection of membership users for which the email address field contains the specified email address.

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.Gets a collection of membership users where the user name contains the specified user name to match.

GeneratePassword()

Genera una password casuale lunga almeno 14 caratteri.Generates a random password that is at least 14 characters long.

GetAllUsers(Int32, Int32, Int32)

Ottiene un insieme di tutti gli utenti nel database di appartenenze SQL Server.Gets a collection of all the users in the SQL Server membership database.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetNumberOfUsersOnline()

Restituisce il numero corrente di utenti connessi all'applicazione.Returns the number of users currently accessing the application.

GetPassword(String, String)

Restituisce la password dell'utente specificato nel database di appartenenze SQL Server.Returns the password for the specified user name from the SQL Server membership database.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(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.Gets the information from the data source for the membership user associated with the specified unique identifier and updates the last activity date/time stamp for the user, if specified.

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.Returns information from the SQL Server membership database for a user and provides an option to update the last activity date/time stamp for the user.

GetUserNameByEmail(String)

Ottiene il nome utente associato all'indirizzo di posta elettronica specificato.Gets the user name associated with the specified email address.

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.Initializes the SQL Server membership provider with the property values specified in the ASP.NET application's configuration file. Questo metodo non deve essere usato direttamente dal codice.This method is not intended to be used directly from your code.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
OnValidatingPassword(ValidatePasswordEventArgs)

Genera l'evento ValidatingPassword se è stato definito un gestore eventi.Raises the ValidatingPassword event if an event handler has been defined.

(Ereditato da MembershipProvider)
ResetPassword(String, String)

Reimposta la password di un utente su una nuova password generata automaticamente.Resets a user's password to a new, automatically generated password.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
UnlockUser(String)

Annulla lo stato di blocco dell'utente in modo da consentire la convalida dell'utente di appartenenza.Clears the user's locked-out status so that the membership user can be validated.

UpdateUser(MembershipUser)

Aggiorna le informazioni riguardanti un utente nel database di appartenenze SQL Server.Updates information about a user in the SQL Server membership database.

ValidateUser(String, String)

Verifica che nome utente e password specificati esistano nel database di appartenenze SQL Server.Verifies that the specified user name and password exist in the SQL Server membership database.

Eventi

ValidatingPassword

Si verifica quando viene creato un utente, viene modificata una password o viene reimpostata una password.Occurs when a user is created, a password is changed, or a password is reset.

(Ereditato da MembershipProvider)

Si applica a

Vedi anche