2 out of 4 rated this helpful - Rate this topic

MembershipProvider Class

Defines the contract that ASP.NET implements to provide membership services using custom membership providers.

Namespace:  System.Web.Security
Assembly:  System.Web.ApplicationServices (in System.Web.ApplicationServices.dll)
public abstract class MembershipProvider : ProviderBase

The MembershipProvider type exposes the following members.

  Name Description
Protected method MembershipProvider Initializes a new instance of the MembershipProvider class.
Top
  Name Description
Public property ApplicationName The name of the application using the custom membership provider.
Public property Description Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs). (Inherited from ProviderBase.)
Public property EnablePasswordReset Indicates whether the membership provider is configured to allow users to reset their passwords.
Public property EnablePasswordRetrieval Indicates whether the membership provider is configured to allow users to retrieve their passwords.
Public property MaxInvalidPasswordAttempts Gets the number of invalid password or password-answer attempts allowed before the membership user is locked out.
Public property MinRequiredNonAlphanumericCharacters Gets the minimum number of special characters that must be present in a valid password.
Public property MinRequiredPasswordLength Gets the minimum length required for a password.
Public property Name Gets the friendly name used to refer to the provider during configuration. (Inherited from ProviderBase.)
Public property PasswordAttemptWindow 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.
Public property PasswordFormat Gets a value indicating the format for storing passwords in the membership data store.
Public property PasswordStrengthRegularExpression Gets the regular expression used to evaluate a password.
Public property RequiresQuestionAndAnswer Gets a value indicating whether the membership provider is configured to require the user to answer a password question for password reset and retrieval.
Public property RequiresUniqueEmail Gets a value indicating whether the membership provider is configured to require a unique e-mail address for each user name.
Top
  Name Description
Public method ChangePassword Processes a request to update the password for a membership user.
Public method ChangePasswordQuestionAndAnswer Processes a request to update the password question and answer for a membership user.
Public method CreateUser Adds a new membership user to the data source.
Protected method DecryptPassword Decrypts an encrypted password.
Public method DeleteUser Removes a user from the membership data source.
Protected method EncryptPassword(Byte[]) Encrypts a password.
Protected method EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) Encrypts the specified password using the specified password-compatibility mode.
Public method Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method FindUsersByEmail Gets a collection of membership users where the e-mail address contains the specified e-mail address to match.
Public method FindUsersByName Gets a collection of membership users where the user name contains the specified user name to match.
Public method GetAllUsers Gets a collection of all the users in the data source in pages of data.
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetNumberOfUsersOnline Gets the number of users currently accessing the application.
Public method GetPassword Gets the password for the specified user name from the data source.
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Public method GetUser(Object, Boolean) Gets user information from the data source based on the unique identifier for the membership user. Provides an option to update the last-activity date/time stamp for the user.
Public method GetUser(String, Boolean) Gets information from the data source for a user. Provides an option to update the last-activity date/time stamp for the user.
Public method GetUserNameByEmail Gets the user name associated with the specified e-mail address.
Public method Initialize Initializes the provider. (Inherited from ProviderBase.)
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Protected method OnValidatingPassword Raises the ValidatingPassword event if an event handler has been defined.
Public method ResetPassword Resets a user's password to a new, automatically generated password.
Public method ToString Returns a string that represents the current object. (Inherited from Object.)
Public method UnlockUser Clears a lock so that the membership user can be validated.
Public method UpdateUser Updates information about a user in the data source.
Public method ValidateUser Verifies that the specified user name and password exist in the data source.
Top
  Name Description
Public event ValidatingPassword Occurs when a user is created, a password is changed, or a password is reset.
Top

ASP.NET membership is designed to enable you to easily use a number of different membership providers for your ASP.NET applications. You can use the supplied membership providers that are included with the .NET Framework, or you can implement your own provider.

Note Note

If you are not familiar with the membership features of ASP.NET, see Introduction to Membership before continuing. For a list of other topics related to membership, see Managing Users by Using Membership.

When implementing a custom membership provider, you are required to inherit the MembershipProvider abstract class.

There are two primary reasons for creating a custom membership provider.

  • 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.

  • 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. A common example of this would be membership data that already exists in a SQL Server database for a company or Web site.

The MembershipProvider abstract class inherits from the ProviderBase abstract class. MembershipProvider implementations must also implement the required members of ProviderBase.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
Is in System.Web.dll for Framework 2.0
FYI: 
Framework 2.0 : This class is in System.Web.dll >> System.Web.Security Namespace
Framework 4.0 : Moved to System.Web.ApplicationServices.dll >> System.Web.Security Namespace
Ado.net entity framework membership provider
very nice example of Membership provider in Entity Framework
http://efmembership.codeplex.com/
membershipprovidor
$0publicabstractclass MembershipProvider : ProviderBase$0