SqlMembershipProvider Třída

Definice

Obor názvů:

System.Web.Security

Sestavení:

System.Web.dll

Spravuje ukládání informací o členství pro ASP.NET aplikaci v SQL Server databázi.

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 Web.config soubor pro ASP.NET aplikaci nakonfigurovanou SqlMembershipProviderpro použití .

<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

Note

ASP.NET zprostředkovatelé členství nahradili 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žívá třídy Membership a MembershipUser k poskytování služeb členství pro aplikaci ASP.NET pomocí databáze SQL Server. Nelze použít SqlMembershipProvider bez SQL Server. Pokud má počítač nainstalovaný SQL Server Express s výchozím názvem instance a povolenou instancí uživatele, objekt SqlMembershipProvider 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 spustitelný soubor Aspnet_regsql.exe nalezený ve složce %systemroot%\Microsoft.NET\Framework\ versionNumber a zadejte možnost -A m (například aspnet_regsql.exe -A m). Vytvořená databáze se nazývá Aspnetdb. Případně spusťte Aspnet_regsql.exe, aby se vytáhla režim konfigurace grafického uživatelského rozhraní a zvolila konfiguraci všech funkcí ASP.NET.

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

Soubor Machine.config definuje výchozí instanci SqlMembershipProvider s názvem AspNetSqlMembershipProvider, která se připojí k výchozí instanci SQL Server Express na místním počítači. Tuto instanci poskytovatele 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 vaši aplikaci ASP.NET.

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

Konstruktory

Name	Description
SqlMembershipProvider()	Inicializuje novou instanci SqlMembershipProvider třídy.

Vlastnosti

Name	Description
ApplicationName	Získá nebo nastaví název aplikace pro ukládání a načítání informací o členství pro.
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 určující, zda je poskytovatel členství SYSTÉMU SQL Server nakonfigurován tak, aby uživatelům umožnil resetovat svá hesla.
EnablePasswordRetrieval	Získá hodnotu určující, zda je poskytovatel členství SYSTÉMU SQL Server nakonfigurován tak, aby uživatelům umožnil načíst svá hesla.
MaxInvalidPasswordAttempts	Získá počet neplatnýchpokusůch
MinRequiredNonAlphanumericCharacters	Získá minimální počet speciálních znaků, které musí být přítomné v platném hesle.
MinRequiredPasswordLength	Získá minimální délku požadovanou pro heslo.
Name	Získá popisný název použitý k odkazování na zprostředkovatele během konfigurace. (Zděděno od ProviderBase)
PasswordAttemptWindow	Získá časové intervaly, mezi kterými se po sobě jdoucí neúspěšné pokusy o zadání platného hesla nebo odpovědi na heslo jsou sledovány.
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 určující, zda je zprostředkovatel členství SYSTÉMU SQL Server nakonfigurován tak, 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 SQL Server zprostředkovatel členství je nakonfigurován tak, aby vyžadoval jedinečnou e-mailovou adresu pro každé uživatelské jméno.

Metody

Name	Description
ChangePassword(String, String, String)	Upraví heslo uživatele.
ChangePasswordQuestionAndAnswer(String, String, String, String)	Aktualizuje otázku a odpověď hesla 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í SQL Serveru.
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	Zašifruje zadané heslo pomocí zadaného režimu kompatibility s heslem. (Zděděno od MembershipProvider)
EncryptPassword(Byte[])	Zašifruje heslo. (Zděděno od MembershipProvider)
Equals(Object)	Určuje, zda je zadaný objekt roven 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é adresy 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, které má délku 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í funkce hash. (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á Type aktuální instance. (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 čas poslední aktivity pro uživatele, pokud je zadán.
GetUser(String, Boolean)	Vrátí informace z databáze členství SQL Serveru 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 SQL Server členství s hodnotami vlastností zadanými v konfiguračním souboru ASP.NET aplikace. Tato metoda není určená k použití přímo z kódu.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnValidatingPassword(ValidatePasswordEventArgs)	ValidatingPassword Vyvolá událost, 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 uzamčený stav 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ěřuje, že zadané uživatelské jméno a heslo existují v databázi členství SQL Serveru.

Událost

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

Viz také

• Úvod do členství v ASP.NET