profile-Element (ASP.NET-Einstellungsschema)

  • Artikel

Konfiguriert die Parameter für die Verwaltung von Benutzerprofilwerten mithilfe des ASP.NET-Profils.

Dieses Element ist neu in .NET Framework, Version 2.0.

<profile
    enabled="true|false"
    inherits="fully qualified type reference"
    automaticSaveEnabled="true|false"
    defaultProvider="provider name">
    <properties>...</properties>
    <providers>...</providers>
</profile>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribut

Beschreibung

enabled

Optionales Boolean-Attribut.

Gibt an, ob ASP.NET-Benutzerprofile aktiviert sind. Im Fall von true sind ASP.NET-Benutzerprofile aktiviert.

Die Standardeinstellung ist true.

defaultProvider

Optionales String-Attribut.

Gibt den Namen des Standardprofilanbieters an.

Weitere Informationen finden Sie unter Provider.

Die Standardeinstellung ist AspNetSqlProfileProvider.

inherits

Optionales String-Attribut.

Enthält einen Typverweis für einen benutzerdefinierten Typ, der aus der abstrakten ProfileBase-Klasse abgeleitet ist. ASP.NET generiert dynamisch eine ProfileCommon-Klasse, die von diesem Typ erbt, und platziert diese Klasse in der Profile-Eigenschaft des aktuellen HttpContext.

automaticSaveEnabled

Optionales Boolean-Attribut.

Gibt an, ob das Benutzerprofil am Ende der Ausführung einer ASP.NET-Seite automatisch gespeichert wird. Im Fall von true wird das Benutzerprofil am Ende der Ausführung einer ASP.NET-Seite automatisch gespeichert.

Das ProfileModule-Objekt speichert nur dann ein Benutzerprofil, wenn das Modul erkennt, dass das Profil geändert wurde. Das heißt, die IsDirty-Eigenschaft ist true. Weitere Informationen finden Sie unter Übersicht über ASP.NET-Profileigenschaften.

Die Standardeinstellung ist true.

Untergeordnete Elemente

Element

Beschreibungen

properties

Erforderliches Element.

Definiert eine Auflistung von Benutzerprofileigenschaften und Eigenschaftengruppen.

providers

Optionales Element.

Definiert eine Auflistung von Profilanbietern.

Ü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 profile-Element zugreifen und diese ändern können, finden Sie unter ProfileSection.

Standardkonfiguration

Das folgende profile-Standardelement wird in der Datei Machine.config von .NET Framework, Version 2.0, konfiguriert.

<profile>
  <providers>
        <add name="AspNetSqlProfileProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Profile.SqlProfileProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> 
  </providers>
</profile>

Beispiel

Das folgende Codebeispiel zeigt, wie die Datei Web.config einer ASP.NET-Anwendung für die Verwendung eines benutzerdefinierten SqlProfileProvider-Anbieters konfiguriert wird.

<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>
        <clear/>
        <add name="SqlProvider" 
             type="System.Web.Security.SqlMembershipProvider" 
             connectionStringName="SqlServices"
             applicationName="SampleApplication"
             enablePasswordRetrieval="true"
             enablePasswordReset="true"
             passwordFormat="Encrypted"
             requiresQuestionAndAnswer="true" />
      </providers>
    </membership>

    <profile defaultProvider="SqlProvider">
      <providers>
        <clear />
        <add name="SqlProvider"
             type="System.Web.Profile.SqlProfileProvider"
             connectionStringName="SqlServices"
             applicationName="SampleApplication"
             description="SqlProfileProvider for SampleApplication" />
      </providers>

      <properties>
        <add name="ZipCode" />
        <add name="CityAndState" />
      </properties>
    </profile>
  </system.web>
</configuration>

Elementinformationen

Konfigurationsabschnittshandler

System.Web.Configuration.ProfileSection

Konfigurationsmember

SystemWebSectionGroup.Profile

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

properties-Element für profile (ASP.NET-Einstellungsschema)

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

ProfileSection

System.Configuration

System.Web.Configuration

Konzepte

Übersicht über ASP.NET-Profileigenschaften

Übersicht über die ASP.NET-Konfiguration

ASP.NET-Webserversteuerelemente und Browserfunktionen

Absichern der ASP.NET-Konfiguration

ASP.NET-Konfigurationsszenarios

Weitere Ressourcen

ASP.NET-Konfigurationsdateien

ASP.NET-Konfigurationseinstellungen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurations-API