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

Artikel
09/03/2008

Aktualisiert: November 2007

Fügt einer Benutzerprofilgruppe eine Eigenschaft hinzu.

<configuration>-Element
  system.web-Element (ASP.NET-Einstellungsschema)
    profile-Element (ASP.NET-Einstellungsschema)
      properties-Element für profile (ASP.NET-Einstellungsschema)
        group-Element für properties für profile (ASP.NET-Einstellungsschema)
          add-Element für group für profile (ASP.NET-Einstellungsschema)

<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 sowie übergeordnete Elemente beschrieben.

Attribute

Attribut	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 Eigenschaftenwerten verwendeten Profilanbieter an. Der Wert dieses 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 Eigenschaftenwert 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. 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 string null 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 den Zeichenfolgenwert an, der vom Profilanbieter für die Eigenschaft verwendet werden muss. Dieses Attribut kann auf einen beliebigen Zeichenfolgenwert festgelegt werden. Wenn das customProviderData-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.
group	Definiert eine Gruppierung von Benutzerprofileigenschaften.

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 festgelegt wird, das eine Eigenschaftengruppe mit dem Gruppennamen Address enthält. Den gruppierten Eigenschaften, die für die Profile-Eigenschaft generiert wurden, 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

Freigeben über

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

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Konzepte

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen