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 Serveru.

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 ASP.NET aplikaci pomocí databáze SQL Serveru. Bez SQL Serveru nelze použít SqlMembershipProvider . Pokud je na počítači nainstalovaný 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 Serveru.

Soubor Machine.config definuje výchozí SqlMembershipProvider instanci s názvem AspNetSqlMembershipProvider , která se připojuje k výchozí instanci SQL Serveru 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 zprostředkovatel členství SQL Serveru nakonfigurovaný tak, aby uživatelům umožňoval resetovat hesla.
EnablePasswordRetrieval	Získá hodnotu označující, zda je zprostředkovatel členství SQL Serveru nakonfigurovaný tak, aby uživatelům umožňoval načíst jejich 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í systému SQL Server.
PasswordStrengthRegularExpression	Získá regulární výraz použitý k vyhodnocení hesla.
RequiresQuestionAndAnswer	Získá hodnotu označující, zda je zprostředkovatel členství SQL Serveru nakonfigurovaný tak, aby vyžadoval, aby uživatel odpověděl na otázku hesla pro resetování a načtení hesla.
RequiresUniqueEmail	Získá hodnotu určující, zda je zprostředkovatel členství SQL Serveru 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)	Aktualizuje otázku a odpověď na heslo pro uživatele v databázi členství SQL Serveru.
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	Přidá nového uživatele do databáze členství SQL Serveru.
DecryptPassword(Byte[])	Dešifruje šifrované heslo. (Zděděno od MembershipProvider)
DeleteUser(String, Boolean)	Odebere informace o členství uživatele z databáze členství systému 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 Serveru.
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 Serveru.
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 Serveru pro uživatele a poskytuje možnost aktualizovat datum a časové razítko 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 Serveru s hodnotami vlastností zadanými 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)	Aktualizuje informace o uživateli v databázi členství SQL Serveru.
ValidateUser(String, String)	Ověří, že v databázi členství SQL Serveru 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í