SqlMembershipProvider Osztály

Definíció

Névtér:

System.Web.Security

Szerelvény:

System.Web.dll

Egy ASP.NET-alkalmazás tagsági adatainak tárolását kezeli egy SQL Server adatbázisban.

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

Öröklődés

Object

ProviderBase

MembershipProvider

SqlMembershipProvider

Példák

Az alábbi példakód egy SqlMembershipProvider használatára konfigurált ASP.NET alkalmazás Web.config fájlját mutatja be.

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

Megjegyzések

Note

ASP.NET tagságszolgáltatókat felváltotta ASP.NET Identity. Határozottan javasoljuk, hogy frissítse az alkalmazásokat, hogy a tagságszolgáltatók helyett az ASP.NET Identitásplatformot használják.

Ezt az osztályt a Membership és a MembershipUser osztály használja, hogy tagsági szolgáltatásokat nyújtson egy ASP.NET alkalmazáshoz egy SQL Server-adatbázis használatával. Nem használhat SqlMembershipProvider SQL Server nélkül. Ha a számítógép az alapértelmezett példánynévvel és felhasználói instancinggal rendelkező SQL Server Expresst telepítette, a SqlMembershipProvider objektum létrehoz egy aspnetdb nevű adatbázist az alkalmazás App_Data könyvtárában az alkalmazás első futtatásakor.

Az adatbázis manuális létrehozásához futtassa a Aspnet_regsql.exe mappában található %systemroot%\Microsoft.NET\Framework\ versionNumber végrehajtható fájlt, és adja meg a -A m beállítást (például aspnet_regsql.exe -A m). A létrehozott adatbázis neve Aspnetdb. Másik lehetőségként futtassa a Aspnet_regsql.exe parancsot a grafikus felhasználói felület konfigurációs módjának lekéréséhez, és válassza az összes ASP.NET szolgáltatás konfigurálását.

Ha a tagságszolgáltató olyan kapcsolati karakterlánc van konfigurálva, amely integrált biztonságot használ, a ASP.NET alkalmazás folyamatfiókjának jogosultsággal kell rendelkeznie a SQL Server adatbázishoz való csatlakozáshoz.

A Machine.config fájl egy alapértelmezett SqlMembershipProviderAspNetSqlMembershipProvider nevű példányt határoz meg, amely a helyi gépen az alapértelmezett SQL Server Express-példányhoz csatlakozik. Ezt a szolgáltatópéldányt akkor használhatja, ha az alapértelmezett példánynévvel telepítette SQL Server Expresst, vagy saját példányt is megadhat a ASP.NET alkalmazás Web.config fájljában.

Ha a passwordCompatMode attribútumot Framework40 értékre állítja, az alkalmazás használhatja a 4. ASP.NET-ben hozzáadott kivonatolási és titkosítási tagsági beállításokat. Ha azonban a passwordCompatMode attribútum értéke Framework20, csak a 2.0 ASP.NET kivonatolási és titkosítási tagsági beállításai, ASP.NET 3.5 és ASP.NET 3.5 SP1 használható. Az alapértelmezett érték a Framework20. További információért lásd MembershipPasswordCompatibilityMode.

Konstruktorok

Name	Description
SqlMembershipProvider()	Inicializálja a SqlMembershipProvider osztály új példányát.

Tulajdonságok

Name	Description
ApplicationName	Lekéri vagy beállítja az alkalmazás nevét a tagsági adatok tárolásához és lekéréséhez.
Description	Rövid, rövid leírást kap, amely alkalmas a felügyeleti eszközökben vagy más felhasználói felületeken való megjelenítésre. (Öröklődés forrása ProviderBase)
EnablePasswordReset	Beolvas egy értéket, amely jelzi, hogy a SQL Server tagságszolgáltató úgy van-e konfigurálva, hogy a felhasználók visszaállíthassák a jelszavukat.
EnablePasswordRetrieval	Beolvas egy értéket, amely jelzi, hogy a SQL Server tagságszolgáltató úgy van-e konfigurálva, hogy lehetővé tegye a felhasználók számára a jelszavak lekérését.
MaxInvalidPasswordAttempts	Lekéri a tagsági felhasználó zárolása előtt engedélyezett érvénytelen jelszó- vagy jelszó-válasz kísérletek számát.
MinRequiredNonAlphanumericCharacters	Beolvasja az érvényes jelszóban megjelenítendő speciális karakterek minimális számát.
MinRequiredPasswordLength	Lekéri a jelszóhoz szükséges minimális hosszt.
Name	Lekéri a szolgáltatóra való hivatkozáshoz használt rövid nevet a konfiguráció során. (Öröklődés forrása ProviderBase)
PasswordAttemptWindow	Lekéri azt az időkeretet, amely között egymást követő sikertelen próbálkozások követik az érvényes jelszó- vagy jelszó-válaszokat.
PasswordFormat	A SQL Server tagsági adatbázisban lévő jelszavak tárolásának formátumát jelző értéket kap.
PasswordStrengthRegularExpression	Lekéri a jelszó kiértékeléséhez használt reguláris kifejezést.
RequiresQuestionAndAnswer	Beolvas egy értéket, amely jelzi, hogy a SQL Server tagságszolgáltatója úgy van-e konfigurálva, hogy a felhasználónak válaszolnia kell egy jelszóval kapcsolatos kérdésre a jelszó alaphelyzetbe állításához és lekéréséhez.
RequiresUniqueEmail	Beolvas egy értéket, amely jelzi, hogy a SQL Server tagságszolgáltatója úgy van-e konfigurálva, hogy minden felhasználónévhez egyedi e-mail-címet igényeljen.

Metódusok

Name	Description
ChangePassword(String, String, String)	Módosítja a felhasználó jelszavát.
ChangePasswordQuestionAndAnswer(String, String, String, String)	Frissíti a SQL Server-tagság adatbázisában lévő felhasználó jelszóval kapcsolatos kérdését és válaszát.
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	Új felhasználót ad hozzá a SQL Server tagsági adatbázishoz.
DecryptPassword(Byte[])	Titkosított jelszó visszafejtése. (Öröklődés forrása MembershipProvider)
DeleteUser(String, Boolean)	Eltávolítja a felhasználó tagsági adatait a SQL Server tagsági adatbázisból.
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	A megadott jelszót a megadott jelszókompatibilitási módban titkosítja. (Öröklődés forrása MembershipProvider)
EncryptPassword(Byte[])	Jelszó titkosítása. (Öröklődés forrása MembershipProvider)
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
FindUsersByEmail(String, Int32, Int32, Int32)	Olyan tagságfelhasználói gyűjteményt ad vissza, amelyhez az e-mail-cím mező a megadott e-mail-címet tartalmazza.
FindUsersByName(String, Int32, Int32, Int32)	Lekéri a tagsági felhasználók gyűjteményét, ahol a felhasználónév tartalmazza a megadott felhasználónevet.
GeneratePassword()	Legalább 14 karakter hosszú véletlenszerű jelszót hoz létre.
GetAllUsers(Int32, Int32, Int32)	Lekéri a SQL Server tagsági adatbázis összes felhasználójának gyűjteményét.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetNumberOfUsersOnline()	Az alkalmazáshoz jelenleg hozzáférő felhasználók számát adja vissza.
GetPassword(String, String)	A megadott felhasználónév jelszavát adja vissza a SQL Server tagsági adatbázisból.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
GetUser(Object, Boolean)	Lekéri a megadott egyedi azonosítóhoz társított tagsági felhasználó adatait az adatforrásból, és ha meg van adva, frissíti a felhasználó utolsó tevékenységdátum-/időbélyegét.
GetUser(String, Boolean)	Adatokat ad vissza a SQL Server tagsági adatbázisból egy felhasználó számára, és lehetővé teszi a felhasználó utolsó tevékenységdátum-/időbélyegének frissítését.
GetUserNameByEmail(String)	Lekéri a megadott e-mail-címhez társított felhasználónevet.
Initialize(String, NameValueCollection)	Inicializálja a SQL Server tagságszolgáltatót a ASP.NET alkalmazás konfigurációs fájljában megadott tulajdonságértékekkel. Ez a módszer nem használható közvetlenül a kódból.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnValidatingPassword(ValidatePasswordEventArgs)	Eseményt ValidatingPassword emel ki, ha egy eseménykezelőt definiált. (Öröklődés forrása MembershipProvider)
ResetPassword(String, String)	Visszaállítja a felhasználó jelszavát egy új, automatikusan létrehozott jelszóra.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
UnlockUser(String)	Törli a felhasználó kizárt állapotát, hogy a tagsági felhasználó érvényesíthető legyen.
UpdateUser(MembershipUser)	Frissíti a SQL Server tagsági adatbázisban lévő felhasználó adatait.
ValidateUser(String, String)	Ellenőrzi, hogy a megadott felhasználónév és jelszó létezik-e a SQL Server tagsági adatbázisban.

esemény

Name	Description
ValidatingPassword	A felhasználó létrehozásakor, a jelszó módosításakor vagy a jelszó alaphelyzetbe állításakor fordul elő. (Öröklődés forrása MembershipProvider)

Lásd még

• Bevezetés a tagság ASP.NET