membership-Element (ASP.NET-Einstellungsschema)
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Konfiguriert die Parameter für die Verwaltung und Authentifizierung von Benutzerkonten mithilfe der ASP.NET-Mitgliedschaft.
Dieses Element ist neu in .NET Framework, Version 2.0.
<membership
defaultProvider="provider name"
userIsOnlineTimeWindow="number of minutes"
hashAlgorithmType="SHA1">
<providers>...</providers>
</membership>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
---|---|
defaultProvider |
Optionales String-Attribut. Der Name des Standardmitgliedschaftsanbieters. Weitere Informationen finden Sie unter Provider. Der Standardwert ist AspNetSqlProvider. |
userIsOnlineTimeWindow |
Optionales String-Attribut. Gibt die Anzahl von Minuten an, für die ein Benutzerkonto nach der Datums-/Uhrzeitangabe der letzten Benutzeraktivität als online betrachtet wird. Die Standardeinstellung ist 15 Minuten. |
hashAlgorithmType |
Optionales String-Attribut. Gibt den Namen des Verschlüsselungsalgorithmus an, der zum Erstellen der Hashwerte für Kennwörter verwendet wird. Der Wert dieses Attributs entspricht dem name-Attribut eines nameEntry-Elements im cryptoNameMapping-Konfigurationsabschnitt. Weitere Informationen zum Angeben eines benutzerdefinierten Hashalgorithmus finden Sie unter Zuordnen von Algorithmennamen zu kryptografischen Klassen. Der Standardwert ist SHA1. |
Untergeordnete Elemente
Element |
Beschreibung |
---|---|
providers |
Optionales Element. Definiert eine Auflistung von Mitgliedschaftsanbietern. |
Übergeordnete Elemente
Element |
Beschreibung |
---|---|
configuration |
Gibt das erforderliche Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird. |
system.web |
Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an. |
Hinweise
Informationen darüber, wie Sie im Anwendungscode auf Konfigurationswerte für das membership-Element zugreifen und diese ändern können, finden Sie unter MembershipSection.
Standardkonfiguration
Das folgende membership-Standardelement wird in der Datei Machine.config von .NET Framework, Version 2.0, konfiguriert.
<membership>
<providers>
<add name="AspNetSqlMembershipProvider" type="System.Web.Security.SqlMembershipProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" connectionStringName="LocalSqlServer" enablePasswordRetrieval="false" enablePasswordReset="true" requiresQuestionAndAnswer="true" applicationName="/" requiresUniqueEmail="false" passwordFormat="Hashed" maxInvalidPasswordAttempts="5" minRequiredPasswordLength="7" minRequiredNonalphanumericCharacters="1" passwordAttemptWindow="10" passwordStrengthRegularExpression="" />
</providers>
</membership>
Beispiel
Das folgende Codebeispiel zeigt, wie eine ASP.NET-Anwendung so konfiguriert wird, dass sie den SqlMembershipProvider-Anbieter zum Speichern und Abrufen von Benutzerkontoinformationen verwendet.
<configuration>
<connectionStrings>
<add name="SqlServices"
connectionString="Data Source=MySqlServer;Integrated Security=SSPI;Initial
Catalog=aspnetdb;" />
</connectionStrings>
<system.web>
<membership
defaultProvider="SqlProvider"
userIsOnlineTimeWindow="20">
<providers>
<remove name="AspNetSqlProvider" />
<add name="SqlProvider"
type="System.Web.Security.SqlMembershipProvider"
connectionStringName="SqlServices"
enablePasswordRetrieval="false"
enablePasswordReset="true"
requiresQuestionAndAnswer="true"
passwordFormat="Hashed"
applicationName="/" />
</providers>
</membership>
</system.web>
</configuration>
Elementinformationen
Konfigurationsabschnittshandler |
|
Konfigurationsmember |
|
Konfigurierbare Speicherorte |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene |
Anforderungen |
Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0 .NET Framework, Version 2.0 Microsoft Visual Studio 2005 |
Siehe auch
Aufgaben
How to: Lock ASP.NET Configuration Settings
Referenz
system.web-Element (ASP.NET-Einstellungsschema)
providers-Element für membership (ASP.NET-Einstellungsschema)
Konzepte
ASP.NET Configuration Overview
ASP.NET Server Controls and Browser Capabilities
Weitere Ressourcen
Managing Users Using ASP.NET Membership
ASP.NET-Konfigurationseinstellungen