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

Article
09/04/2008

Mise à jour : novembre 2007

Ajoute une propriété au profil utilisateur.

Cet élément est une nouveauté du .NET Framework version 2.0.

<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)
        add, élément de properties 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 l'attribut provider 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 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, comme suit : 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 la valeur null pour String afin d'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 que l'attribut customProviderData peut avoir une valeur de chaîne quelconque que le fournisseur de profils doit utiliser pour la propriété. Si cet attribut est défini, la valeur est placée dans la collection Attributes de la propriété et elle est indexée en fonction du 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 groupes de propriétés du 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 une propriété ZipCode de type String et une propriété RecentSearchList de type StringCollection. La propriété Profile générée aura des accesseurs fortement typés pour chacune des propriétés spécifiées. Pour plus d'informations sur le profil utilisateur et obtenir un exemple de définition et de lecture des 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>
   <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>

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