SqlMembershipProvider Třída

Definice

Obor názvů:

System.Web.Security

Sestavení:

System.Web.dll

Spravuje úložiště informací o členství pro aplikaci ASP.NET v databázi 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

Dědičnost

Object

ProviderBase

MembershipProvider

SqlMembershipProvider

Příklady

Následující příklad kódu ukazuje soubor Web.config pro ASP.NET aplikaci nakonfigurovanou tak, aby používala 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>  

Poznámky

Poznámka

ASP.NET zprostředkovatelé členství byli nahrazeni ASP.NET Identity. Důrazně doporučujeme aktualizovat aplikace tak, aby místo zprostředkovatelů členství používaly platformu ASP.NET Identity Platform.

Tuto třídu používají Membership třídy a MembershipUser k poskytování služeb členství pro aplikaci ASP.NET pomocí databáze SQL Server. Bez SQL Server nelze použítSqlMembershipProvider. Pokud je v počítači nainstalována SQL Server Express s výchozím názvem instance a povolenou instancí uživatele, SqlMembershipProvider objekt vytvoří databázi s názvem aspnetdb v adresáři aplikace App_Data při prvním spuštění aplikace.

Pokud chcete databázi vytvořit ručně, spusťte Aspnet_regsql.exe spustitelný soubor, který se nachází ve %systemroot%\Microsoft.NET\Framework\ versionNumber složce, a zadejte -A m možnost (například aspnet_regsql.exe -A m). Vytvořená databáze se nazývá Aspnetdb. Případně spusťte příkaz Aspnet_regsql.exe pro načtení režimu konfigurace grafického uživatelského rozhraní a zvolte konfiguraci všech funkcí ASP.NET.

Pokud je zprostředkovatel členství nakonfigurovaný s připojovacím řetězcem, který používá integrované zabezpečení, musí mít účet procesu ASP.NET aplikace oprávnění pro připojení k databázi SQL Server.

Soubor Machine.config definuje výchozí SqlMembershipProvider instanci s názvemAspNetSqlMembershipProvider, která se připojuje k výchozí instanci SQL Server Express na místním počítači. Tuto instanci zprostředkovatele můžete použít, pokud jste nainstalovali SQL Server Express s výchozím názvem instance, nebo můžete definovat vlastní instanci v souboru Web.config pro ASP.NET aplikaci.

Pokud atribut nastavíte passwordCompatMode na Framework40, aplikace může použít možnosti hashování a šifrování členství, které byly přidány v ASP.NET 4. Pokud passwordCompatMode je však atribut nastavený na Framework20, lze použít pouze možnosti hashování a šifrování členství z ASP.NET 2.0, ASP.NET 3.5 a ASP.NET 3.5 SP1. Výchozí hodnota je Framework20. Další informace naleznete v tématu MembershipPasswordCompatibilityMode.

Konstruktory

SqlMembershipProvider()

Inicializuje novou instanci SqlMembershipProvider třídy.

Vlastnosti

ApplicationName	Získá nebo nastaví název aplikace pro ukládání a načítání informací o členství.
Description	Získá stručný popis vhodný pro zobrazení v nástrojích pro správu nebo jiných uživatelských rozhraních (UI). (Zděděno od ProviderBase)
EnablePasswordReset	Získá hodnotu označující, zda je SQL Server zprostředkovatel členství nakonfigurovaný tak, aby uživatelům umožňoval resetovat hesla.
EnablePasswordRetrieval	Získá hodnotu označující, zda je zprostředkovatel členství SQL Server nakonfigurován tak, aby uživatelům umožňoval načítat hesla.
MaxInvalidPasswordAttempts	Získá počet povolených pokusů o neplatné heslo nebo odpověď na heslo před uzamčením uživatele členství.
MinRequiredNonAlphanumericCharacters	Získá minimální počet speciálních znaků, které musí být přítomny v platném hesle.
MinRequiredPasswordLength	Získá minimální délku vyžadovanou pro heslo.
Name	Získá popisný název použitý k odkaz na poskytovatele během konfigurace. (Zděděno od ProviderBase)
PasswordAttemptWindow	Získá časové období, mezi kterým jsou sledovány po sobě jdoucí neúspěšné pokusy o zadání platného hesla nebo odpovědí na heslo.
PasswordFormat	Získá hodnotu označující formát pro ukládání hesel v databázi členství SQL Server.
PasswordStrengthRegularExpression	Získá regulární výraz použitý k vyhodnocení hesla.
RequiresQuestionAndAnswer	Získá hodnotu označující, zda je SQL Server zprostředkovatel členství nakonfigurovaný tak, aby uživatel odpověděl na otázku hesla pro resetování a načtení hesla.
RequiresUniqueEmail	Získá hodnotu označující, zda je zprostředkovatel členství SQL Server nakonfigurován tak, aby vyžadoval jedinečnou e-mailovou adresu pro každé uživatelské jméno.

Metody

ChangePassword(String, String, String)	Upraví heslo uživatele.
ChangePasswordQuestionAndAnswer(String, String, String, String)	Aktualizace otázku a odpověď na heslo pro uživatele v databázi členství SQL Server.
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	Přidá nového uživatele do databáze členství SQL Server.
DecryptPassword(Byte[])	Dešifruje šifrované heslo. (Zděděno od MembershipProvider)
DeleteUser(String, Boolean)	Odebere informace o členství uživatele z databáze členství SQL Server.
EncryptPassword(Byte[])	Zašifruje heslo. (Zděděno od MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	Zašifruje zadané heslo pomocí zadaného režimu kompatibility s hesly. (Zděděno od MembershipProvider)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
FindUsersByEmail(String, Int32, Int32, Int32)	Vrátí kolekci uživatelů členství, pro které pole e-mailová adresa obsahuje zadanou e-mailovou adresu.
FindUsersByName(String, Int32, Int32, Int32)	Získá kolekci uživatelů členství, kde uživatelské jméno obsahuje zadané uživatelské jméno, které se má shodovat.
GeneratePassword()	Vygeneruje náhodné heslo o délce nejméně 14 znaků.
GetAllUsers(Int32, Int32, Int32)	Získá kolekci všech uživatelů v databázi členství SQL Server.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetNumberOfUsersOnline()	Vrátí počet uživatelů, kteří k aplikaci aktuálně přistupují.
GetPassword(String, String)	Vrátí heslo pro zadané uživatelské jméno z databáze členství SQL Server.
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
GetUser(Object, Boolean)	Získá informace ze zdroje dat pro uživatele členství přidruženého k zadanému jedinečnému identifikátoru a aktualizuje datum a časové razítko poslední aktivity pro uživatele, pokud je zadáno.
GetUser(String, Boolean)	Vrátí informace z databáze členství SQL Server pro uživatele a poskytuje možnost aktualizovat datum a čas poslední aktivity pro uživatele.
GetUserNameByEmail(String)	Získá uživatelské jméno přidružené k zadané e-mailové adrese.
Initialize(String, NameValueCollection)	Inicializuje zprostředkovatele členství SQL Server pomocí hodnot vlastností zadaných v konfiguračním souboru ASP.NET aplikace. Tato metoda není určena k použití přímo z kódu.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnValidatingPassword(ValidatePasswordEventArgs)	Vyvolá událost, ValidatingPassword pokud byla definována obslužná rutina události. (Zděděno od MembershipProvider)
ResetPassword(String, String)	Resetuje heslo uživatele na nové, automaticky vygenerované heslo.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
UnlockUser(String)	Vymaže stav uzamčení uživatele, aby bylo možné ověřit uživatele členství.
UpdateUser(MembershipUser)	Aktualizace informace o uživateli v databázi členství SQL Server.
ValidateUser(String, String)	Ověří, že v databázi členství SQL Server existuje zadané uživatelské jméno a heslo.

Událost

ValidatingPassword

Nastane při vytvoření uživatele, změně hesla nebo resetování hesla. (Zděděno od MembershipProvider)

Viz také

• Úvod do ASP.NET členství