MembershipProvider Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Definiuje kontrakt, który ASP.NET implementuje usługi członkostwa przy użyciu niestandardowych dostawców członkostwa.
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
- Dziedziczenie
- Pochodne
Uwagi
Uwaga
ASP.NET dostawcy członkostwa zostały zastąpione przez usługę ASP.NET Identity. Zdecydowanie zalecamy aktualizowanie aplikacji w celu korzystania z platformy ASP.NET Identity zamiast dostawców członkostwa.
ASP.NET członkostwo zostało zaprojektowane tak, aby umożliwić łatwe korzystanie z wielu różnych dostawców członkostwa dla aplikacji ASP.NET. Możesz użyć dostarczonych dostawców członkostwa dołączonych do programu .NET Framework lub zaimplementować własnego dostawcę.
Uwaga
Jeśli nie znasz funkcji członkostwa ASP.NET, zobacz Wprowadzenie do członkostwa przed kontynuowaniem. Aby uzyskać listę innych tematów związanych z członkostwem, zobacz Zarządzanie użytkownikami przy użyciu członkostwa.
Podczas implementowania niestandardowego dostawcy członkostwa wymagane jest dziedziczenie klasy abstrakcyjnej MembershipProvider .
Istnieją dwa główne przyczyny tworzenia niestandardowego dostawcy członkostwa.
Musisz przechowywać informacje o członkostwie w źródle danych, które nie jest obsługiwane przez dostawców członkostwa dołączonych do programu .NET Framework, takich jak baza danych FoxPro, baza danych Oracle lub inne źródło danych.
Musisz zarządzać informacjami o członkostwie przy użyciu schematu bazy danych, który różni się od schematu bazy danych używanego przez dostawców, którzy są dostarczane z programem .NET Framework. Typowym przykładem może być dane członkostwa, które już istnieją w bazie danych programu SQL Server dla firmy lub witryny sieci Web.
Klasa abstrakcyjna MembershipProvider dziedziczy z klasy abstrakcyjnej ProviderBase . MembershipProviderimplementacje muszą również implementować wymagane elementy członkowskie .ProviderBase
Konstruktory
MembershipProvider() |
Inicjuje nowe wystąpienie klasy MembershipProvider. |
Właściwości
ApplicationName |
Nazwa aplikacji przy użyciu niestandardowego dostawcy członkostwa. |
Description |
Pobiera krótki, przyjazny opis odpowiedni do wyświetlania w narzędziach administracyjnych lub innych interfejsach użytkownika (UI). (Odziedziczone po ProviderBase) |
EnablePasswordReset |
Wskazuje, czy dostawca członkostwa jest skonfigurowany tak, aby umożliwić użytkownikom resetowanie haseł. |
EnablePasswordRetrieval |
Wskazuje, czy dostawca członkostwa jest skonfigurowany tak, aby umożliwić użytkownikom pobieranie haseł. |
MaxInvalidPasswordAttempts |
Pobiera liczbę nieprawidłowych prób hasła lub odpowiedzi na hasło dozwolonych przed zablokowaniem użytkownika członkostwa. |
MinRequiredNonAlphanumericCharacters |
Pobiera minimalną liczbę znaków specjalnych, które muszą znajdować się w prawidłowym haśle. |
MinRequiredPasswordLength |
Pobiera minimalną długość wymaganą dla hasła. |
Name |
Pobiera przyjazną nazwę używaną do odwoływania się do dostawcy podczas konfiguracji. (Odziedziczone po ProviderBase) |
PasswordAttemptWindow |
Pobiera liczbę minut, w których maksymalna liczba prób nieprawidłowego hasła lub odpowiedzi na hasło jest dozwolona przed zablokowaniem użytkownika członkostwa. |
PasswordFormat |
Pobiera wartość wskazującą format przechowywania haseł w magazynie danych członkostwa. |
PasswordStrengthRegularExpression |
Pobiera wyrażenie regularne używane do oceny hasła. |
RequiresQuestionAndAnswer |
Pobiera wartość wskazującą, czy dostawca członkostwa jest skonfigurowany tak, aby wymagać od użytkownika odpowiedzi na pytanie o hasło dotyczące resetowania hasła i pobierania. |
RequiresUniqueEmail |
Pobiera wartość wskazującą, czy dostawca członkostwa jest skonfigurowany tak, aby wymagał unikatowego adresu e-mail dla każdej nazwy użytkownika. |
Metody
ChangePassword(String, String, String) |
Przetwarza żądanie aktualizacji hasła dla użytkownika członkostwa. |
ChangePasswordQuestionAndAnswer(String, String, String, String) |
Przetwarza żądanie aktualizacji pytania i odpowiedzi na hasło dla użytkownika członkostwa. |
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) |
Dodaje nowego użytkownika członkostwa do źródła danych. |
DecryptPassword(Byte[]) |
Odszyfrowuje zaszyfrowane hasło. |
DeleteUser(String, Boolean) |
Usuwa użytkownika ze źródła danych członkostwa. |
EncryptPassword(Byte[]) |
Szyfruje hasło. |
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) |
Szyfruje określone hasło przy użyciu określonego trybu zgodności haseł. |
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
FindUsersByEmail(String, Int32, Int32, Int32) |
Pobiera kolekcję użytkowników członkostwa, na których adres e-mail zawiera określony adres e-mail zgodny. |
FindUsersByName(String, Int32, Int32, Int32) |
Pobiera kolekcję użytkowników członkostwa, w których nazwa użytkownika zawiera określoną nazwę użytkownika, która ma być zgodna. |
GetAllUsers(Int32, Int32, Int32) |
Pobiera kolekcję wszystkich użytkowników w źródle danych na stronach danych. |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetNumberOfUsersOnline() |
Pobiera liczbę użytkowników, którzy obecnie uzyskują dostęp do aplikacji. |
GetPassword(String, String) |
Pobiera hasło dla określonej nazwy użytkownika ze źródła danych. |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
GetUser(Object, Boolean) |
Pobiera informacje o użytkowniku ze źródła danych na podstawie unikatowego identyfikatora użytkownika członkostwa. Udostępnia opcję aktualizowania sygnatury daty/godziny ostatniego działania dla użytkownika. |
GetUser(String, Boolean) |
Pobiera informacje ze źródła danych użytkownika. Udostępnia opcję aktualizowania sygnatury daty/godziny ostatniego działania dla użytkownika. |
GetUserNameByEmail(String) |
Pobiera nazwę użytkownika skojarzona z określonym adresem e-mail. |
Initialize(String, NameValueCollection) |
Inicjuje konstruktora konfiguracji. (Odziedziczone po ProviderBase) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
OnValidatingPassword(ValidatePasswordEventArgs) |
Zgłasza zdarzenie, ValidatingPassword jeśli zdefiniowano procedurę obsługi zdarzeń. |
ResetPassword(String, String) |
Resetuje hasło użytkownika do nowego, automatycznie wygenerowanego hasła. |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
UnlockUser(String) |
Czyści blokadę, aby można było zweryfikować użytkownika członkostwa. |
UpdateUser(MembershipUser) |
Aktualizuje informacje o użytkowniku w źródle danych. |
ValidateUser(String, String) |
Sprawdza, czy określona nazwa użytkownika i hasło istnieją w źródle danych. |
Zdarzenia
ValidatingPassword |
Występuje po utworzeniu użytkownika, zmianie hasła lub zresetowaniu hasła. |