add, élément de group pour profile (Schéma des paramètres ASP.NET)

Article
09/04/2008

Mise à jour : novembre 2007

Ajoute une propriété à un groupe de profils utilisateur.

<configuration>, élément
  system.web, élément (Schéma des paramètres ASP.NET)
    profile, élément (Schéma des paramètres ASP.NET)
      properties, élément de profile (Schéma des paramètres ASP.NET)
        group, élément de properties pour profile (Schéma des paramètres ASP.NET)
          add, élément de group pour profile (Schéma des paramètres ASP.NET)

<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" />
/>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
name	Attribut String requis. Spécifie le nom de la propriété. Cette valeur est utilisée comme nom de la propriété pour la classe de profil générée automatiquement et comme valeur d'index pour la propriété dans la collection Properties. Le nom de la propriété ne peut pas contenir de point (.). Pour plus d'informations sur la génération automatique de propriétés de profil utilisateur, consultez Vue d'ensemble des propriétés du profil ASP.NET.
type	Attribut String facultatif. Spécifie le type de la propriété. La valeur par défaut est String.
provider	Attribut String facultatif. Spécifie le fournisseur de profils utilisé pour stocker et récupérer des valeurs pour la propriété. La valeur de cet attribut est le nom de l'un des fournisseurs de profils spécifiés dans l'élément providers. Si aucun nom de fournisseur n'est spécifié, le fournisseur par défaut spécifié dans l'élément profile est utilisé. Pour plus d'informations sur les fournisseurs de profils, consultez Fournisseurs de profils ASP.NET.
serializeAs	Attribut SettingsSerializeAs facultatif. Spécifie le format de sérialisation de la valeur de la propriété dans le magasin de données. Le format de sérialisation utilisé par défaut est spécifique au fournisseur. C'est le fournisseur qui détermine la sérialisation utilisée, à savoir la sérialisation String dans le cas du fournisseur SQL.
allowAnonymous	Attribut Boolean facultatif. Spécifie si la propriété peut être obtenue ou définie, si l'utilisateur de l'application est anonyme. Si sa valeur est true, la propriété peut être obtenue ou définie si l'utilisateur de l'application est anonyme. La valeur par défaut est false.
defaultValue	Attribut String facultatif. Spécifie la valeur par défaut, en l'absence d'une valeur pour la propriété Profile dans le magasin de données. Si le type de la propriété est sérialisé à l'aide de la sérialisation XML, cet attribut peut avoir pour valeur une chaîne XML qui représente une instance sérialisée du type de la propriété. Si le type de la propriété est sérialisé à l'aide de la sérialisation binaire, cet attribut peut avoir pour valeur une chaîne codée en base 64 qui représente une instance sérialisée du type de la propriété. Si la propriété est un type référence, il est possible d'utiliser string null pour indiquer que la propriété Profile doit retourner null pour les profils non initialisés.
readOnly	Attribut Boolean facultatif. Spécifie si la propriété peut être lue, mais pas définie. Si la valeur est true, la propriété peut être lue, mais pas définie. La valeur par défaut est false.
customProviderData	Attribut String facultatif. Spécifie la valeur de chaîne que le fournisseur de profils doit utiliser pour la propriété. Cet attribut peut prendre n'importe quelle valeur de chaîne. Si l'attribut customProviderData est défini, la valeur est placée dans la collection Attributes de la propriété et elle est indexée par le nom "CustomProviderData".

Éléments enfants

Aucun

Éléments parents

Élément	Description
configuration	Spécifie l'élément racine dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
system.web	Spécifie l'élément racine de la section de configuration ASP.NET.
profile	Configure le profil utilisateur pour une application.
properties	Définit une collection de propriétés et de groupes de propriétés du profil utilisateur.
group	Définit un regroupement de propriétés de profil utilisateur.

Notes

Pour plus d'informations sur l'accès aux valeurs de configuration de l'élément profile dans le code d'application et leur modification, consultez ProfileSection.

Exemple

L'exemple de fichier Web.config suivant montre comment spécifier un profil utilisateur qui contient un groupe de propriétés dont le nom est Address. Les propriétés groupées générées pour la propriété Profile seront précédées du nom du groupe (par exemple,Profile.Address.Street). Pour plus d'informations sur le profil utilisateur et un exemple de définition et de lecture des groupes de propriétés du profil utilisateur, consultez Vue d'ensemble des propriétés du profil ASP.NET.

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

Informations sur les éléments

Gestionnaire de section de configuration	System.Web.Configuration.ProfileSection
Membre de configuration	SystemWebSectionGroup.Profile
Emplacements configurables	Machine.config Web.config racine Web.config au niveau de l'application
Configuration requise	Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0 .NET Framework version 2.0 Microsoft Visual Studio 2005

Voir aussi

Partager via

add, élément de group pour profile (Schéma des paramètres ASP.NET)

Attributs et éléments

Attributs

Éléments enfants

Éléments parents

Notes

Exemple

Informations sur les éléments

Voir aussi

Tâches

Concepts

Référence

Autres ressources

Ressources supplémentaires