membership-Element (ASP.NET-Einstellungsschema)

  • Artikel

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, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribut

Beschreibung

defaultProvider

Optionales String-Attribut.

Der Name des Standardmitgliedschaftsanbieters. Weitere Informationen finden Sie unter Provider.

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

System.Web.Configuration.MembershipSection

Konfigurationsmember

Membership

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

Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen

Referenz

system.web-Element (ASP.NET-Einstellungsschema)

<configuration>-Element

providers-Element für membership (ASP.NET-Einstellungsschema)

System.Configuration

System.Web.Configuration

Konzepte

Übersicht über die ASP.NET-Konfiguration

ASP.NET-Webserversteuerelemente und Browserfunktionen

Absichern der ASP.NET-Konfiguration

ASP.NET-Konfigurationsszenarios

Weitere Ressourcen

Verwalten von Benutzern mithilfe der Mitgliedschaft

ASP.NET-Konfigurationsdateien

ASP.NET-Konfigurationseinstellungen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurations-API