SqlMembershipProvider Klas

Definitie

Naamruimte:: System.Web.Security

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee beheert u de opslag van lidmaatschapsgegevens voor een ASP.NET toepassing in een SQL Server-database.

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

Overname: Object

ProviderBase

MembershipProvider
SqlMembershipProvider

Voorbeelden

In het volgende codevoorbeeld ziet u het Web.config-bestand voor een ASP.NET-toepassing die is geconfigureerd voor het gebruik van een 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>

Opmerkingen

Note

ASP.NET lidmaatschapsproviders zijn vervangen door ASP.NET Identity. We raden u ten zeerste aan om apps bij te werken voor het gebruik van het ASP.NET Identity Platform in plaats van de lidmaatschapsproviders.

Deze klasse wordt gebruikt door de klassen Membership en MembershipUser om lidmaatschapsservices te bieden voor een ASP.NET-toepassing met behulp van een SQL Server-database. U kunt geen SqlMembershipProvider gebruiken zonder SQL Server. Wanneer op uw computer SQL Server Express is geïnstalleerd met de standaardinstantienaam en door de gebruiker ingeschakeld, maakt het SqlMembershipProvider-object een database met de naam aspnetdb in de map App_Data van de toepassing wanneer de toepassing voor het eerst wordt uitgevoerd.

Als u de database handmatig wilt maken, voert u het uitvoerbare bestand Aspnet_regsql.exe uit in de map %systemroot%\Microsoft.NET\Framework\ versionNumber en geeft u de optie -A m op (bijvoorbeeld aspnet_regsql.exe -A m). De gemaakte database heet Aspnetdb. U kunt ook Aspnet_regsql.exe uitvoeren om de GUI-configuratiemodus op te halen en ervoor te kiezen om alle ASP.NET-functies te configureren.

Als de lidmaatschapsprovider is geconfigureerd met een verbindingsreeks die gebruikmaakt van geïntegreerde beveiliging, moet het procesaccount van de ASP.NET-toepassing rechten hebben om verbinding te maken met de SQL Server-database.

Het bestand Machine.config definieert een standaardexemplaren SqlMembershipProvider met de naam AspNetSqlMembershipProvider die verbinding maakt met het standaardexemplaren van SQL Server Express op de lokale computer. U kunt dit exemplaar van de provider gebruiken als u SQL Server Express hebt geïnstalleerd met de standaardexemplarennaam of u kunt uw eigen exemplaar definiëren in het Web.config-bestand voor uw ASP.NET toepassing.

Als u het kenmerk passwordCompatMode instelt op Framework40, kan de toepassing de hash- en versleutelingslidmaatschapsopties gebruiken die zijn toegevoegd in ASP.NET 4. Als het kenmerk passwordCompatMode echter is ingesteld op Framework20, kunnen alleen de opties voor hashing en versleutelingslidmaatschap van de ASP.NET 2.0, ASP.NET 3.5 en ASP.NET 3.5 SP1 worden gebruikt. De standaardwaarde is Framework20. Zie MembershipPasswordCompatibilityMode voor meer informatie.

Constructors

Name	Description
SqlMembershipProvider()	Initialiseert een nieuw exemplaar van de SqlMembershipProvider klasse.

Eigenschappen

Name	Description
ApplicationName	Hiermee wordt de naam van de toepassing opgehaald of ingesteld om lidmaatschapsgegevens voor op te slaan en op te halen.
Description	Hiermee krijgt u een korte, beschrijvende beschrijving die geschikt is voor weergave in beheerhulpprogramma's of andere gebruikersinterfaces (UIS's). (Overgenomen van ProviderBase)
EnablePasswordReset	Hiermee wordt een waarde opgehaald die aangeeft of de SQL Server lidmaatschapsprovider is geconfigureerd zodat gebruikers hun wachtwoorden opnieuw kunnen instellen.
EnablePasswordRetrieval	Hiermee wordt een waarde opgehaald die aangeeft of de SQL Server lidmaatschapsprovider is geconfigureerd zodat gebruikers hun wachtwoorden kunnen ophalen.
MaxInvalidPasswordAttempts	Hiermee haalt u het aantal ongeldige wachtwoord- of wachtwoordantwoordpogingen op dat is toegestaan voordat de lidmaatschapsgebruiker is vergrendeld.
MinRequiredNonAlphanumericCharacters	Hiermee haalt u het minimale aantal speciale tekens op dat aanwezig moet zijn in een geldig wachtwoord.
MinRequiredPasswordLength	Hiermee haalt u de minimale lengte op die is vereist voor een wachtwoord.
Name	Hiermee haalt u de beschrijvende naam op die wordt gebruikt om tijdens de configuratie naar de provider te verwijzen. (Overgenomen van ProviderBase)
PasswordAttemptWindow	Hiermee wordt het tijdvenster opgehaald waarin opeenvolgende mislukte pogingen om een geldig wachtwoord of wachtwoordantwoord te geven, worden bijgehouden.
PasswordFormat	Hiermee wordt een waarde opgehaald die de indeling aangeeft voor het opslaan van wachtwoorden in de SQL Server lidmaatschapsdatabase.
PasswordStrengthRegularExpression	Hiermee haalt u de reguliere expressie op die wordt gebruikt om een wachtwoord te evalueren.
RequiresQuestionAndAnswer	Hiermee wordt een waarde opgehaald die aangeeft of de SQL Server lidmaatschapsprovider zo is geconfigureerd dat de gebruiker een wachtwoordvraag moet beantwoorden voor het opnieuw instellen en ophalen van wachtwoorden.
RequiresUniqueEmail	Hiermee wordt een waarde opgehaald die aangeeft of de SQL Server lidmaatschapsprovider is geconfigureerd voor het vereisen van een uniek e-mailadres voor elke gebruikersnaam.

Methoden

Name	Description
ChangePassword(String, String, String)	Hiermee wijzigt u het wachtwoord van een gebruiker.
ChangePasswordQuestionAndAnswer(String, String, String, String)	Hiermee werkt u de wachtwoordvraag en het antwoord voor een gebruiker in de SQL Server lidmaatschapsdatabase bij.
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	Voegt een nieuwe gebruiker toe aan de SQL Server lidmaatschapsdatabase.
DecryptPassword(Byte[])	Ontsleutelt een versleuteld wachtwoord. (Overgenomen van MembershipProvider)
DeleteUser(String, Boolean)	Hiermee verwijdert u de lidmaatschapsgegevens van een gebruiker uit de SQL Server lidmaatschapsdatabase.
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	Hiermee wordt het opgegeven wachtwoord versleuteld met behulp van de opgegeven modus voor wachtwoordcompatibiliteit. (Overgenomen van MembershipProvider)
EncryptPassword(Byte[])	Hiermee wordt een wachtwoord versleuteld. (Overgenomen van MembershipProvider)
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
FindUsersByEmail(String, Int32, Int32, Int32)	Retourneert een verzameling lidmaatschapsgebruikers waarvoor het e-mailadresveld het opgegeven e-mailadres bevat.
FindUsersByName(String, Int32, Int32, Int32)	Hiermee haalt u een verzameling lidmaatschapsgebruikers op waarvan de gebruikersnaam de opgegeven gebruikersnaam bevat die overeenkomt.
GeneratePassword()	Hiermee wordt een willekeurig wachtwoord gegenereerd dat minimaal 14 tekens lang is.
GetAllUsers(Int32, Int32, Int32)	Hiermee haalt u een verzameling op van alle gebruikers in de SQL Server lidmaatschapsdatabase.
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetNumberOfUsersOnline()	Retourneert het aantal gebruikers dat momenteel toegang heeft tot de toepassing.
GetPassword(String, String)	Retourneert het wachtwoord voor de opgegeven gebruikersnaam uit de SQL Server lidmaatschapsdatabase.
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
GetUser(Object, Boolean)	Hiermee haalt u de informatie op uit de gegevensbron voor de lidmaatschapsgebruiker die is gekoppeld aan de opgegeven unieke id en werkt u de laatste datum/tijdstempel voor de gebruiker bij, indien opgegeven.
GetUser(String, Boolean)	Retourneert informatie uit de SQL Server lidmaatschapsdatabase voor een gebruiker en biedt een optie voor het bijwerken van het datum/tijdstempel van de laatste activiteit voor de gebruiker.
GetUserNameByEmail(String)	Hiermee haalt u de gebruikersnaam op die is gekoppeld aan het opgegeven e-mailadres.
Initialize(String, NameValueCollection)	Initialiseert de SQL Server lidmaatschapsprovider met de eigenschapswaarden die zijn opgegeven in het configuratiebestand van de ASP.NET toepassing. Deze methode is niet bedoeld om rechtstreeks vanuit uw code te worden gebruikt.
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnValidatingPassword(ValidatePasswordEventArgs)	Hiermee wordt de ValidatingPassword gebeurtenis gegenereerd als er een gebeurtenis-handler is gedefinieerd. (Overgenomen van MembershipProvider)
ResetPassword(String, String)	Hiermee stelt u het wachtwoord van een gebruiker opnieuw in op een nieuw, automatisch gegenereerd wachtwoord.
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)
UnlockUser(String)	Hiermee wist u de vergrendelde status van de gebruiker, zodat de lidmaatschapsgebruiker kan worden gevalideerd.
UpdateUser(MembershipUser)	Hiermee wordt informatie over een gebruiker in de SQL Server-lidmaatschapsdatabase bijgewerkt.
ValidateUser(String, String)	Controleert of de opgegeven gebruikersnaam en het opgegeven wachtwoord aanwezig zijn in de SQL Server lidmaatschapsdatabase.

gebeurtenis

Name	Description
ValidatingPassword	Treedt op wanneer een gebruiker wordt gemaakt, een wachtwoord wordt gewijzigd of een wachtwoord opnieuw wordt ingesteld. (Overgenomen van MembershipProvider)

Van toepassing op

Zie ook

Invoering voor ASP.NET lidmaatschap

Feedback

Is deze pagina nuttig?