SqlMembershipProvider Klasa

Definicja

Przestrzeń nazw:

System.Web.Security

Zestaw:

System.Web.dll

Zarządza przechowywaniem informacji o członkostwie dla aplikacji ASP.NET w bazie danych SQL Server.

public ref class SqlMembershipProvider : System::Web::Security::MembershipProvider

public class SqlMembershipProvider : System.Web.Security.MembershipProvider

type SqlMembershipProvider = class
    inherit MembershipProvider

Public Class SqlMembershipProvider
Inherits MembershipProvider

Dziedziczenie

Object

ProviderBase

MembershipProvider

SqlMembershipProvider

Przykłady

Poniższy przykład kodu przedstawia plik Web.config dla aplikacji ASP.NET skonfigurowanej do używania elementu SqlMembershipProvider.

<configuration>  
  <connectionStrings>  
    <add name="SqlServices" connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=aspnetdb;" />  
  </connectionStrings>  
  <system.web>  
    <authentication mode="Forms" >  
      <forms loginUrl="login.aspx"  
        name=".ASPXFORMSAUTH" />  
    </authentication>  
    <authorization>  
      <deny users="?" />  
    </authorization>  
    <membership defaultProvider="SqlProvider"  
      userIsOnlineTimeWindow="15">  
      <providers>  
        <add   
          name="SqlProvider"   
          type="System.Web.Security.SqlMembershipProvider"   
          connectionStringName="SqlServices"  
          applicationName="MyApplication"  
          enablePasswordRetrieval="false"  
          enablePasswordReset="true"  
          requiresQuestionAndAnswer="true"  
          requiresUniqueEmail="false"  
          passwordFormat="Hashed"  
          maxInvalidPasswordAttempts="5"  
          passwordAttemptWindow="10" />  
      </providers>  
    </membership>  
  </system.web>  
</configuration>  

Uwagi

Uwaga

ASP.NET dostawcy członkostwa zostali zastąpioni przez ASP.NET Identity. Zdecydowanie zalecamy aktualizowanie aplikacji w celu korzystania z platformy ASP.NET Identity zamiast dostawców członkostwa.

Ta klasa jest używana przez Membership klasy i MembershipUser do świadczenia usług członkostwa dla aplikacji ASP.NET przy użyciu bazy danych SQL Server. Nie można użyć elementu SqlMembershipProvider bez SQL Server. Gdy komputer SQL Server Express zainstalowany z domyślną nazwą wystąpienia i włączonym tworzeniem wystąpienia przez użytkownika, SqlMembershipProvider obiekt utworzy bazę danych o nazwie aspnetdb w katalogu aplikacji App_Data przy pierwszym uruchomieniu aplikacji.

Aby ręcznie utworzyć bazę danych, uruchom Aspnet_regsql.exe plik wykonywalny znaleziony w folderze %systemroot%\Microsoft.NET\Framework\ versionNumber i określ -A m opcję (na przykład aspnet_regsql.exe -A m). Utworzona baza danych nosi nazwę Aspnetdb. Możesz też uruchomić polecenie Aspnet_regsql.exe , aby ściągnąć tryb konfiguracji graficznego interfejsu użytkownika i skonfigurować wszystkie funkcje ASP.NET.

Jeśli dostawca członkostwa jest skonfigurowany przy użyciu parametrów połączenia korzystających ze zintegrowanych zabezpieczeń, konto procesu aplikacji ASP.NET musi mieć uprawnienia do łączenia się z bazą danych SQL Server.

Plik Machine.config definiuje wystąpienie domyślne SqlMembershipProvider o nazwie AspNetSqlMembershipProvider , które łączy się z domyślnym wystąpieniem SQL Server Express na komputerze lokalnym. Możesz użyć tego wystąpienia dostawcy, jeśli zainstalowano SQL Server Express z domyślną nazwą wystąpienia lub możesz zdefiniować własne wystąpienie w pliku Web.config dla aplikacji ASP.NET.

Jeśli ustawisz passwordCompatMode atrybut na Framework40wartość , aplikacja może użyć opcji tworzenia skrótów i członkostwa w szyfrowaniu, które zostały dodane w ASP.NET 4. Jeśli passwordCompatMode jednak atrybut jest ustawiony na Framework20wartość , można użyć tylko opcji tworzenia skrótów i szyfrowania z ASP.NET 2.0, ASP.NET 3.5 i ASP.NET 3.5 SP1. Wartość domyślna to Framework20. Aby uzyskać więcej informacji, zobacz MembershipPasswordCompatibilityMode.

Konstruktory

SqlMembershipProvider()

Inicjuje nowe wystąpienie klasy SqlMembershipProvider.

Właściwości

ApplicationName	Pobiera lub ustawia nazwę aplikacji do przechowywania i pobierania informacji o członkostwie.
Description	Pobiera krótki, przyjazny opis odpowiedni do wyświetlania w narzędziach administracyjnych lub innych interfejsach użytkownika (UI). (Odziedziczone po ProviderBase)
EnablePasswordReset	Pobiera wartość wskazującą, czy dostawca członkostwa SQL Server jest skonfigurowany tak, aby umożliwić użytkownikom resetowanie haseł.
EnablePasswordRetrieval	Pobiera wartość wskazującą, czy dostawca członkostwa SQL Server jest skonfigurowany tak, aby umożliwić użytkownikom pobieranie haseł.
MaxInvalidPasswordAttempts	Pobiera liczbę nieprawidłowych prób hasła lub odpowiedzi na hasło, zanim użytkownik członkostwa zostanie zablokowany.
MinRequiredNonAlphanumericCharacters	Pobiera minimalną liczbę znaków specjalnych, które muszą być obecne 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 przedział czasu, między którym śledzone są kolejne nieudane próby podania prawidłowego hasła lub odpowiedzi na hasło.
PasswordFormat	Pobiera wartość wskazującą format przechowywania haseł w bazie danych członkostwa SQL Server.
PasswordStrengthRegularExpression	Pobiera wyrażenie regularne używane do oceny hasła.
RequiresQuestionAndAnswer	Pobiera wartość wskazującą, czy dostawca członkostwa SQL Server jest skonfigurowany tak, aby wymagać od użytkownika odpowiedzi na pytanie dotyczące hasła dotyczące resetowania hasła i pobierania.
RequiresUniqueEmail	Pobiera wartość wskazującą, czy dostawca członkostwa SQL Server jest skonfigurowany tak, aby wymagał unikatowego adresu e-mail dla każdej nazwy użytkownika.

Metody

ChangePassword(String, String, String)	Modyfikuje hasło użytkownika.
ChangePasswordQuestionAndAnswer(String, String, String, String)	Aktualizacje pytanie i odpowiedź na hasło użytkownika w bazie danych członkostwa SQL Server.
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	Dodaje nowego użytkownika do bazy danych członkostwa SQL Server.
DecryptPassword(Byte[])	Odszyfrowuje zaszyfrowane hasło. (Odziedziczone po MembershipProvider)
DeleteUser(String, Boolean)	Usuwa informacje o członkostwie użytkownika z bazy danych członkostwa SQL Server.
EncryptPassword(Byte[])	Szyfruje hasło. (Odziedziczone po MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	Szyfruje określone hasło przy użyciu określonego trybu zgodności haseł. (Odziedziczone po MembershipProvider)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FindUsersByEmail(String, Int32, Int32, Int32)	Zwraca kolekcję użytkowników członkostwa, dla których pole adresu e-mail zawiera określony adres e-mail.
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.
GeneratePassword()	Generuje losowe hasło o długości co najmniej 14 znaków.
GetAllUsers(Int32, Int32, Int32)	Pobiera kolekcję wszystkich użytkowników w bazie danych członkostwa SQL Server.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetNumberOfUsersOnline()	Zwraca liczbę użytkowników, którzy obecnie uzyskują dostęp do aplikacji.
GetPassword(String, String)	Zwraca hasło dla określonej nazwy użytkownika z bazy danych członkostwa SQL Server.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetUser(Object, Boolean)	Pobiera informacje ze źródła danych użytkownika członkostwa skojarzonego z określonym unikatowym identyfikatorem i aktualizuje ostatnią datę/sygnaturę czasową działania dla użytkownika, jeśli zostanie określona.
GetUser(String, Boolean)	Zwraca informacje z bazy danych członkostwa SQL Server dla użytkownika i udostępnia opcję zaktualizowania ostatniej sygnatury daty/godziny działania dla użytkownika.
GetUserNameByEmail(String)	Pobiera nazwę użytkownika skojarzona z określonym adresem e-mail.
Initialize(String, NameValueCollection)	Inicjuje dostawcę członkostwa SQL Server z wartościami właściwości określonymi w pliku konfiguracji aplikacji ASP.NET. Ta metoda nie jest przeznaczona do użycia bezpośrednio z kodu.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnValidatingPassword(ValidatePasswordEventArgs)	Zgłasza zdarzenie, ValidatingPassword jeśli zdefiniowano procedurę obsługi zdarzeń. (Odziedziczone po MembershipProvider)
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 stan zablokowanego użytkownika, aby można było zweryfikować użytkownika członkostwa.
UpdateUser(MembershipUser)	Aktualizacje informacje o użytkowniku w bazie danych członkostwa SQL Server.
ValidateUser(String, String)	Sprawdza, czy określona nazwa użytkownika i hasło istnieją w bazie danych członkostwa SQL Server.

Zdarzenia

ValidatingPassword

Występuje po utworzeniu użytkownika, zmianie hasła lub zresetowaniu hasła. (Odziedziczone po MembershipProvider)

Zobacz też

• Wprowadzenie do członkostwa w ASP.NET