Freigeben über

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

  • Artikel

Definiert eine Gruppierung von Benutzerprofileigenschaften.

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

<group name="group name">
    <add... />
    <remove./>
</group>

Attribute und Elemente

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

Attribute

Attribut

Beschreibung

name

Erforderliches String-Attribut.

Der Name der Eigenschaftengruppe. Dieser Wert wird als Bezeichner für die automatisch generierte Gruppenprofilklasse verwendet. Der Gruppenname darf keinen Punkt (.) enthalten.

Weitere Informationen zum automatischen Generieren von Benutzerprofileigenschaften finden Sie unter Übersicht über ASP.NET-Profileigenschaften.

Untergeordnete Elemente

Element

Beschreibung

add

Optionales Element

Fügt der Gruppe der Benutzerprofileigenschaften eine Eigenschaft hinzu.

remove

Optionales Element

Entfernt eine Eigenschaft aus der Gruppe der Benutzerprofileigenschaften.

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

profile

Konfiguriert das Benutzerprofil für eine Anwendung.

properties

Definiert eine Auflistung von Benutzerprofileigenschaften und Eigenschaftengruppen.

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.

Beispiel

Im folgenden Beispiel für die Datei Web.config wird ein Benutzerprofil festgelegt, das eine Eigenschaftengruppe mit dem Gruppennamen Address enthält. Den gruppierten Eigenschaften, die für die Profile-Eigenschaft generiert werden, wird der Gruppenname vorangestellt (z. B. Profile.Address.Street). Informationen zum Benutzerprofil sowie ein Beispiel zum Festlegen und Lesen von Benutzerprofil-Eigenschaftengruppen finden Sie unter Übersicht über ASP.NET-Profileigenschaften.

<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"
            enablePasswordRetrieval="false"
            enablePasswordReset="true"
            requiresQuestionAndAnswer="true" 
            requiresUniqueEmail="false"
            passwordFormat="Hashed"
            applicationName="MyApplication" />
        </providers>
      </membership>

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

        <properties>
          <add name="ZipCode" />
          <group name="Address">
             <add name="Street" />
             <add name="City" />
             <add name="State" />
             <add name="CountryOrRegion" />
          </group>
        </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

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

profile-Element (ASP.NET-Einstellungsschema)

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

<configuration>-Element

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

remove-Element für group 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