MembershipProvider Classe

Definizione

Definisce il contratto implementato da ASP.NET per fornire servizi di appartenenza usando provider di appartenenze personalizzati.Defines the contract that ASP.NET implements to provide membership services using custom membership providers.

public ref class MembershipProvider abstract : System::Configuration::Provider::ProviderBase
public abstract class MembershipProvider : System.Configuration.Provider.ProviderBase
type MembershipProvider = class
    inherit ProviderBase
Public MustInherit Class MembershipProvider
Inherits ProviderBase
Ereditarietà
MembershipProvider
Derivato

Commenti

L'appartenenza a ASP.NET è progettata per consentire all'utente di usare facilmente diversi provider di appartenenze per le applicazioni ASP.NET.ASP.NET membership is designed to enable you to easily use a number of different membership providers for your ASP.NET applications. È possibile utilizzare i provider di appartenenze forniti inclusi nel .NET Framework oppure è possibile implementare un provider personalizzato.You can use the supplied membership providers that are included with the .NET Framework, or you can implement your own provider.

Nota

Se non si ha familiarità con le funzionalità di appartenenza di ASP.NET, vedere Introduzione all'appartenenza prima di continuare.If you are not familiar with the membership features of ASP.NET, see Introduction to Membership before continuing. Per un elenco di altri argomenti relativi all'appartenenza, vedere gestione di utenti tramite l'appartenenza.For a list of other topics related to membership, see Managing Users by Using Membership.

Quando si implementa un provider di appartenenze personalizzato, è necessario ereditare la MembershipProvider classe astratta.When implementing a custom membership provider, you are required to inherit the MembershipProvider abstract class.

Esistono due motivi principali per la creazione di un provider di appartenenze personalizzato.There are two primary reasons for creating a custom membership provider.

  • È necessario archiviare le informazioni sull'appartenenza in un'origine dati non supportata dai provider di appartenenze inclusi nel .NET Framework, ad esempio un database FoxPro, un database Oracle o un'altra origine dati.You need to store membership information in a data source that is not supported by the membership providers included with the .NET Framework, such as a FoxPro database, an Oracle database, or other data source.

  • È necessario gestire le informazioni sull'appartenenza utilizzando uno schema del database diverso dallo schema del database utilizzato dai provider forniti con il .NET Framework.You need to manage membership information using a database schema that is different from the database schema used by the providers that ship with the .NET Framework. Un esempio comune è costituito dai dati di appartenenza già esistenti in un database di SQL Server per una società o un sito Web.A common example of this would be membership data that already exists in a SQL Server database for a company or Web site.

La MembershipProvider classe astratta eredita dalla ProviderBase classe astratta.The MembershipProvider abstract class inherits from the ProviderBase abstract class. MembershipProvider le implementazioni devono inoltre implementare i membri obbligatori di ProviderBase .MembershipProvider implementations must also implement the required members of ProviderBase.

Costruttori

MembershipProvider()

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

Proprietà

ApplicationName

Nome dell'applicazione che usa il provider di appartenenze personalizzato.The name of the application using the custom membership provider.

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

Indica se il provider di appartenenze è configurato per consentire agli utenti di reimpostare la propria password.Indicates whether the membership provider is configured to allow users to reset their passwords.

EnablePasswordRetrieval

Indica se il provider di appartenenze è configurato per consentire agli utenti di recuperare la propria password.Indicates whether the 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 il numero di minuti durante i quali è consentito un numero massimo 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 minutes in which a maximum number of invalid password or password-answer attempts are allowed before the membership user is locked out.

PasswordFormat

Ottiene un valore che indica il formato di archiviazione delle password nell'archivio di dati di appartenenze.Gets a value indicating the format for storing passwords in the membership data store.

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 è configurato per richiedere all'utente di rispondere a una domanda per la reimpostazione e il recupero della password.Gets a value indicating whether the 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 è configurato in modo da richiedere un indirizzo di posta elettronica univoco per ogni nome utente.Gets a value indicating whether the membership provider is configured to require a unique email address for each user name.

Metodi

ChangePassword(String, String, String)

Elabora una richiesta di aggiornamento della password per un utente di appartenenza.Processes a request to update the password for a membership user.

ChangePasswordQuestionAndAnswer(String, String, String, String)

Elabora una richiesta di aggiornamento della domanda e della risposta per la password per un utente di appartenenza.Processes a request to update the password question and answer for a membership user.

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

Aggiunge un nuovo utente di appartenenza all'origine dati.Adds a new membership user to the data source.

DecryptPassword(Byte[])

Decrittografa una password crittografata.Decrypts an encrypted password.

DeleteUser(String, Boolean)

Rimuove un utente dall'origine dati di appartenenza.Removes a user from the membership data source.

EncryptPassword(Byte[])

Crittografa una password.Encrypts a password.

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.

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)

Ottiene una raccolta degli utenti di appartenenza in cui l'indirizzo di posta elettronica contiene l'indirizzo specificato di cui verificare la corrispondenza.Gets a collection of membership users where the email address contains the specified email address to match.

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.

GetAllUsers(Int32, Int32, Int32)

Ottiene una raccolta di tutti gli utenti nell'origine dati nelle pagine di dati.Gets a collection of all the users in the data source in pages of data.

GetHashCode()

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

(Ereditato da Object)
GetNumberOfUsersOnline()

Ottiene il numero di utenti attualmente connessi all'applicazione.Gets the number of users currently accessing the application.

GetPassword(String, String)

Ottiene la password per il nome utente specificato dall'origine dati.Gets the password for the specified user name from the data source.

GetType()

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

(Ereditato da Object)
GetUser(Object, Boolean)

Ottiene informazioni sull'utente dall'origine dati in base all'identificatore univoco dell'utente di appartenenza.Gets user information from the data source based on the unique identifier for the membership user. Fornisce un'opzione per aggiornare l'indicatore di data e ora dell'ultima attività per l'utente.Provides an option to update the last-activity date/time stamp for the user.

GetUser(String, Boolean)

Ottiene informazioni dall'origine dati per un utente.Gets information from the data source for a user. Fornisce un'opzione per aggiornare l'indicatore di data e ora dell'ultima attività per l'utente.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 generatore di configurazione.Initializes the configuration builder.

(Ereditato da ProviderBase)
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.

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)

Cancella un blocco in modo che sia possibile convalidare l'utente di appartenenza.Clears a lock so that the membership user can be validated.

UpdateUser(MembershipUser)

Aggiorna le informazioni relative a un utente nell'origine dati.Updates information about a user in the data source.

ValidateUser(String, String)

Verifica che il nome utente e la password specificati siano presenti nell'origine dati.Verifies that the specified user name and password exist in the data source.

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.

Si applica a

Vedi anche