MembershipProvider Класс

Определение

Описывает контракт, который реализует ASP.NET, чтобы предоставлять службы членства, используя пользовательские поставщики участия.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
Наследование
MembershipProvider
Производный

Комментарии

Членство в ASP.NET позволяет легко использовать несколько различных поставщиков членства для приложений ASP.NET.ASP.NET membership is designed to enable you to easily use a number of different membership providers for your ASP.NET applications. Вы можете использовать указанные поставщики членства, включенные в .NET Framework, или реализовать собственный поставщик.You can use the supplied membership providers that are included with the .NET Framework, or you can implement your own provider.

Примечание

Если вы не знакомы с функциями членства в ASP.NET, см. статью Введение в членство перед продолжением.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.

При реализации пользовательского поставщика членства необходимо наследовать MembershipProvider абстрактный класс.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.

  • Сведения о членстве необходимо хранить в источнике данных, который не поддерживается поставщиками членства, входящими в .NET Framework, например в базу данных FoxPro, базу данных Oracle или другой источник данных.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.

  • Необходимо управлять сведениями о членстве, используя схему базы данных, которая отличается от схемы базы данных, используемой поставщиками, поставляемыми с .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. Распространенный пример — данные членства, которые уже существуют в SQL Server базе данных для компании или веб-сайта.A common example of this would be membership data that already exists in a SQL Server database for a company or Web site.

Абстрактный класс наследует ProviderBase от абстрактного класса. MembershipProviderThe MembershipProvider abstract class inherits from the ProviderBase abstract class. MembershipProviderреализации также должны реализовывать необходимые члены ProviderBase.MembershipProvider implementations must also implement the required members of ProviderBase.

Конструкторы

MembershipProvider()

Инициализирует новый экземпляр класса MembershipProvider.Initializes a new instance of the MembershipProvider class.

Свойства

ApplicationName

Имя приложения, использующего пользовательского поставщика участия.The name of the application using the custom membership provider.

Description

Возвращает краткое, понятное описание, подходящее для отображения в инструментах администрирования или других пользовательских интерфейсах (UI).Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Унаследовано от ProviderBase)
EnablePasswordReset

Показывает, настроена ли в поставщике участия возможность сброса пользователями собственных паролей.Indicates whether the membership provider is configured to allow users to reset their passwords.

EnablePasswordRetrieval

Показывает, настроена ли в поставщике участия возможность извлечения пользователями собственных паролей.Indicates whether the membership provider is configured to allow users to retrieve their passwords.

MaxInvalidPasswordAttempts

Возвращает количество попыток ввода недопустимых пароля или контрольного ответа для пароля, после которых пользователь членства блокируется.Gets the number of invalid password or password-answer attempts allowed before the membership user is locked out.

MinRequiredNonAlphanumericCharacters

Возвращает минимальное количество специальных знаков, которые должны присутствовать в допустимом пароле.Gets the minimum number of special characters that must be present in a valid password.

MinRequiredPasswordLength

Возвращает минимально допустимую длину пароля.Gets the minimum length required for a password.

Name

Возвращает понятное имя, используемое для ссылки на поставщика во время конфигурирования.Gets the friendly name used to refer to the provider during configuration.

(Унаследовано от ProviderBase)
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.

PasswordFormat

Возвращает значение, указывающее формат хранения паролей в хранилище данных членства.Gets a value indicating the format for storing passwords in the membership data store.

PasswordStrengthRegularExpression

Возвращает регулярное выражение, используемое для оценки пароля.Gets the regular expression used to evaluate a password.

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.

RequiresUniqueEmail

Возвращает значение, указывающее, требует ли поставщик членства уникальный адрес электронной почты для каждого имени пользователя.Gets a value indicating whether the membership provider is configured to require a unique email address for each user name.

Методы

ChangePassword(String, String, String)

Обрабатывает запрос на обновление пароля для пользователя членства.Processes a request to update the password for a membership user.

ChangePasswordQuestionAndAnswer(String, String, String, String)

Обрабатывает запрос на обновление контрольного вопроса и ответа при вводе пароля для пользователя членства.Processes a request to update the password question and answer for a membership user.

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

Добавляет нового авторизованного пользователя в источник данных.Adds a new membership user to the data source.

DecryptPassword(Byte[])

Расшифровывает зашифрованный пароль.Decrypts an encrypted password.

DeleteUser(String, Boolean)

Удаляет пользователя из источника данных членства.Removes a user from the membership data source.

EncryptPassword(Byte[])

Шифрует пароль.Encrypts a password.

EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)

Шифрует заданный пароль с использованием заданного режима совместимости паролей.Encrypts the specified password using the specified password-compatibility mode.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
FindUsersByEmail(String, Int32, Int32, Int32)

Возвращает коллекцию авторизованных пользователей, адреса электронной почты которых соответствуют указанному адресу электронной почты.Gets a collection of membership users where the email address contains the specified email address to match.

FindUsersByName(String, Int32, Int32, Int32)

Возвращает коллекцию пользователей членства, у которых часть имени совпадает с указанным значением.Gets a collection of membership users where the user name contains the specified user name to match.

GetAllUsers(Int32, Int32, Int32)

Возвращает коллекцию всех пользователей в источнике данных на страницах данных.Gets a collection of all the users in the data source in pages of data.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetNumberOfUsersOnline()

Получает количество пользователей, осуществляющих текущий доступ к приложению.Gets the number of users currently accessing the application.

GetPassword(String, String)

Возвращает из источника данных пароль для указанного имени пользователя.Gets the password for the specified user name from the data source.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
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.

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.

GetUserNameByEmail(String)

Возвращает имя пользователя, связанное с указанным адресом электронной почты.Gets the user name associated with the specified email address.

Initialize(String, NameValueCollection)

Инициализирует построитель конфигураций.Initializes the configuration builder.

(Унаследовано от ProviderBase)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnValidatingPassword(ValidatePasswordEventArgs)

Вызывает событие ValidatingPassword, если описан обработчик событий.Raises the ValidatingPassword event if an event handler has been defined.

ResetPassword(String, String)

Заменяет пароль пользователя на новый, автоматически сгенерированный пароль.Resets a user's password to a new, automatically generated password.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
UnlockUser(String)

Снимает блокировку так, что пользователь членства может быть проверен.Clears a lock so that the membership user can be validated.

UpdateUser(MembershipUser)

Обновляет информацию о пользователе в источнике данных.Updates information about a user in the data source.

ValidateUser(String, String)

Проверяет существование указанного имени пользователя и пароля в источнике данных.Verifies that the specified user name and password exist in the data source.

События

ValidatingPassword

Происходит при создании пользователя, изменении или сбросе пароля.Occurs when a user is created, a password is changed, or a password is reset.

Применяется к

Дополнительно