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

Fügt dem Benutzerprofil eine Eigenschaft hinzu.

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

<add 
    name="property name" 
    type="fully qualified type reference"
    provider="provider name"
    serializeAs="String|Xml|Binary|ProviderSpecific"
    allowAnonymous="true|false"
    defaultValue="default property value"
    readOnly="true|false"
    customProviderData="data for a custom profile provider" />
/>

Attribute und Elemente

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

Attribute

Attribute	Beschreibung
name	Erforderliches String-Attribut. Gibt den Namen der Eigenschaft an. Dieser Wert wird als Name der Eigenschaft in der automatisch generierten Profilklasse sowie als Indexwert für die Eigenschaft in der Properties-Auflistung verwendet. Der Name der Eigenschaft darf keinen Punkt (.) enthalten. Weitere Informationen zum automatischen Generieren von Benutzerprofileigenschaften finden Sie unter Übersicht über ASP.NET-Profileigenschaften.
type	Optionales String-Attribut. Gibt den Typ der Eigenschaft an. Die Standardeinstellung ist String.
provider	Optionales String-Attribut. Gibt den für das Speichern und Abfragen von Eigenschaftswerten verwendeten Profilanbieter an. Der Wert des provider-Attributs ist der Name eines der im providers-Element angegebenen Profilanbieter. Wenn kein Anbietername angegeben ist, wird der im profile-Element angegebene Standardanbieter verwendet. Weitere Informationen zu Profilanbietern finden Sie unter ASP.NET-Profilanbieter.
serializeAs	Optionales SettingsSerializeAs-Attribut. Gibt das Serialisierungsformat für den Eigenschaftswert im Datenspeicher an. Das Standardserialisierungsformat ist anbieterspezifisch. Die tatsächlich verwendete Serialisierung wird durch den Anbieter bestimmt, im Fall des SQL-Anbieters also String.
allowAnonymous	Optionales Boolean-Attribut. Gibt an, ob die Eigenschaft abgerufen oder festgelegt werden kann, wenn es sich um einen anonymen Anwendungsbenutzer handelt. Im Fall von true kann die Eigenschaft abgerufen oder festgelegt werden, wenn es sich um einen anonymen Anwendungsbenutzer handelt. Die Standardeinstellung ist false.
defaultValue	Optionales String-Attribut. Gibt den Standardwert an, wenn die Profile-Eigenschaft im Datenspeicher keinen Wert enthält, wie im Folgenden veranschaulicht. Wenn der Typ der Eigenschaft mithilfe der XML-Serialisierung serialisiert wird, kann dieses Attribut auf eine XML-Zeichenfolge festgelegt werden, die eine serialisierte Instanz des Eigenschaftentyps darstellt. Wenn der Typ der Eigenschaft mithilfe der binären Serialisierung serialisiert wird, kann dieses Attribut auf eine Base-64-codierte Zeichenfolge festgelegt werden, die eine serialisierte Instanz des Eigenschaftentyps darstellt. Wenn die Eigenschaft ein Verweistyp ist, kann mit dem String null-Wert angegeben werden, dass die Profile-Eigenschaft für nicht initialisierte Profile null zurückgeben muss.
readOnly	Optionales Boolean-Attribut. Gibt an, ob die Eigenschaft gelesen, jedoch nicht festgelegt werden kann. Im Fall von true kann die Eigenschaft gelesen, jedoch nicht festgelegt werden. Die Standardeinstellung ist false.
customProviderData	Optionales String-Attribut. Gibt an, dass das customProviderData-Attribut auf einen beliebigen Zeichenfolgenwert festgelegt werden kann, der vom Profilanbieter für die Eigenschaft verwendet wird. Wenn dieses Attribut festgelegt ist, wird der Wert in der Attributes-Auflistung für die Eigenschaft platziert und mit der Bezeichnung "CustomProviderData" indiziert.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibung
configuration	Gibt das 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

Die folgende Beispieldatei Web.config veranschaulicht, wie ein Benutzerprofil angegeben wird, das eine ZipCode-Eigenschaft vom Typ String und eine RecentSearchList-Eigenschaft vom Typ StringCollection enthält. Die generierte Profile-Eigenschaft 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

Last updated on 2011-08-10

Freigeben über

add-Element für properties 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