MembershipProvider Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет контракт, который ASP.NET реализует для предоставления служб членства с помощью настраиваемых поставщиков членства.
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
- Наследование
- Производный
Комментарии
Note
поставщики членства ASP.NET заменены ASP.NET Identity. Настоятельно рекомендуется обновлять приложения для использования платформы удостоверений ASP.NET вместо поставщиков членства.
ASP.NET членство предназначено для упрощения использования нескольких различных поставщиков членства для приложений ASP.NET. Вы можете использовать предоставленные поставщики членства, включенные в .NET Framework, или реализовать собственный поставщик.
Note
Если вы не знакомы с функциями членства ASP.NET, ознакомьтесь с введением в членство , прежде чем продолжить. Список других разделов, связанных с членством, см. в разделе "Управление пользователями с помощью членства".
При реализации пользовательского поставщика членства необходимо наследовать абстрактный MembershipProvider класс.
Существует две основные причины создания пользовательского поставщика членства.
Необходимо хранить сведения о членстве в источнике данных, который не поддерживается поставщиками членства, включенными в платформу .NET Framework, например базу данных FoxPro, базу данных Oracle или другой источник данных.
Необходимо управлять сведениями о членстве с помощью схемы базы данных, отличной от схемы базы данных, используемой поставщиками, которые передаются с помощью платформы .NET Framework. Типичным примером этого является данные о членстве, которые уже существуют в базе данных SQL Server для компании или веб-сайта.
Абстрактный MembershipProvider класс наследует от абстрактного ProviderBase класса. MembershipProvider реализации также должны реализовывать необходимые члены ProviderBase.
Конструкторы
| Имя | Описание |
|---|---|
| MembershipProvider() |
Инициализирует новый экземпляр класса MembershipProvider. |
Свойства
| Имя | Описание |
|---|---|
| ApplicationName |
Имя приложения с помощью пользовательского поставщика членства. |
| Description |
Получает краткое понятное описание, подходящее для отображения в средствах администрирования или других пользовательских интерфейсах (UIs). (Унаследовано от ProviderBase) |
| EnablePasswordReset |
Указывает, настроен ли поставщик членства, чтобы разрешить пользователям сбрасывать пароли. |
| EnablePasswordRetrieval |
Указывает, настроен ли поставщик членства, чтобы разрешить пользователям получать пароли. |
| MaxInvalidPasswordAttempts |
Получает количество недопустимых попыток пароля или ответа на пароль, разрешенных до блокировки пользователя членства. |
| MinRequiredNonAlphanumericCharacters |
Возвращает минимальное количество специальных символов, которые должны присутствовать в допустимом пароле. |
| MinRequiredPasswordLength |
Возвращает минимальную длину, необходимую для пароля. |
| Name |
Возвращает понятное имя, используемое для ссылки на поставщика во время настройки. (Унаследовано от ProviderBase) |
| PasswordAttemptWindow |
Получает количество минут, в течение которых разрешено максимальное количество попыток с недопустимым паролем или ответом на пароль до блокировки пользователя членства. |
| PasswordFormat |
Возвращает значение, указывающее формат хранения паролей в хранилище данных членства. |
| PasswordStrengthRegularExpression |
Возвращает регулярное выражение, используемое для вычисления пароля. |
| RequiresQuestionAndAnswer |
Возвращает значение, указывающее, настроен ли поставщик членства, чтобы пользователь ответил на вопрос пароля для сброса пароля и извлечения. |
| RequiresUniqueEmail |
Возвращает значение, указывающее, настроен ли поставщик членства для каждого имени пользователя уникальным адресом электронной почты. |
Методы
| Имя | Описание |
|---|---|
| ChangePassword(String, String, String) |
Обрабатывает запрос на обновление пароля для пользователя членства. |
| ChangePasswordQuestionAndAnswer(String, String, String, String) |
Обрабатывает запрос на обновление вопроса пароля и ответа для пользователя членства. |
| CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) |
Добавляет нового пользователя членства в источник данных. |
| DecryptPassword(Byte[]) |
Расшифровывает зашифрованный пароль. |
| DeleteUser(String, Boolean) |
Удаляет пользователя из источника данных членства. |
| EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) |
Шифрует указанный пароль с помощью указанного режима совместимости паролей. |
| EncryptPassword(Byte[]) |
Шифрует пароль. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| FindUsersByEmail(String, Int32, Int32, Int32) |
Возвращает коллекцию пользователей членства, в которой адрес электронной почты содержит указанный адрес электронной почты для сопоставления. |
| FindUsersByName(String, Int32, Int32, Int32) |
Возвращает коллекцию пользователей членства, в которой имя пользователя содержит указанное имя пользователя, соответствующее. |
| GetAllUsers(Int32, Int32, Int32) |
Возвращает коллекцию всех пользователей в источнике данных на страницах данных. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetNumberOfUsersOnline() |
Возвращает количество пользователей, обращаюющихся к приложению. |
| GetPassword(String, String) |
Возвращает пароль для указанного имени пользователя из источника данных. |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| GetUser(Object, Boolean) |
Получает сведения о пользователе из источника данных на основе уникального идентификатора пользователя членства. Предоставляет возможность обновить метку даты и времени последнего действия для пользователя. |
| GetUser(String, Boolean) |
Получает сведения из источника данных для пользователя. Предоставляет возможность обновить метку даты и времени последнего действия для пользователя. |
| GetUserNameByEmail(String) |
Возвращает имя пользователя, связанное с указанным адресом электронной почты. |
| Initialize(String, NameValueCollection) |
Инициализирует построитель конфигураций. (Унаследовано от ProviderBase) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| OnValidatingPassword(ValidatePasswordEventArgs) |
Вызывает событие, ValidatingPassword если был определен обработчик событий. |
| ResetPassword(String, String) |
Сбрасывает пароль пользователя на новый автоматически созданный пароль. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| UnlockUser(String) |
Очищает блокировку, чтобы пользователь членства можно было проверить. |
| UpdateUser(MembershipUser) |
Обновляет сведения о пользователе в источнике данных. |
| ValidateUser(String, String) |
Проверяет наличие указанного имени пользователя и пароля в источнике данных. |
События
| Имя | Описание |
|---|---|
| ValidatingPassword |
Происходит при создании пользователя, изменении пароля или сбросе пароля. |