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

Artikel
08/10/2011

Definiert eine Auflistung von Benutzerprofileigenschaften und Eigenschaftengruppen.

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

<properties>
    <add... />
    <clear />
    <remove... />
    <group>...</group>
</properties>

Attribute und Elemente

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

Attribute

Keine.

Untergeordnete Elemente

Element	Beschreibungen
add	Optionales Element Fügt dem Benutzerprofil eine Eigenschaft hinzu.
clear	Optionales Element Löscht alle zuvor definierten Eigenschaften aus dem Benutzerprofil.
group	Optionales Element Definiert eine Gruppierung von Benutzerprofileigenschaften.
remove	Optionales Element Entfernt eine Eigenschaft aus dem Benutzerprofil.

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

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 eine Datei Web.config ist ein Benutzerprofil angegeben, das eine ZipCode-Eigenschaft vom Typ Zeichenfolge und eine RecentSearchList-Eigenschaft vom Typ StringCollection enthält. Das generierte Profile verfügt über streng typisierte Accessoren für jede der angegebenen Eigenschaften. Informationen zum Benutzerprofil sowie ein Beispiel zum Festlegen und Lesen von Benutzerprofileigenschaften 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>
   <anonymousIdentification enabled="true" />

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

     <properties>
       <add name="ZipCode" allowAnonymous="true" />
       <add name="RecentSearchList"
            type="System.Collections.Specialized.StringCollection"
            serializeAs="Xml"
            allowAnonymous="true" />
      </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

Freigeben über

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

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Referenz

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen