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

Article
09/04/2008

Mise à jour : novembre 2007

Configure des paramètres pour gérer des valeurs de profil utilisateur à l'aide du profil ASP.NET.

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)

<profile
    enabled="true|false"
    inherits="fully qualified type reference"
    automaticSaveEnabled="true|false"
    defaultProvider="provider name">
    <properties>...</properties>
    <providers>...</providers>
</profile>

Attributs et éléments

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

Attributs

Attribut	Description
enabled	Attribut Boolean facultatif. Spécifie si les profils utilisateur ASP.NET sont activés. Si la valeur est true, les profils utilisateur ASP.NET sont activés. La valeur par défaut est true.
defaultProvider	Attribut String facultatif. Spécifie le nom du fournisseur de profils par défaut. Pour plus d'informations, consultez Provider. La valeur par défaut est AspNetSqlProfileProvider.
inherits	Attribut String facultatif. Contient une référence de type pour un type personnalisé qui dérive de la classe abstraite ProfileBase. ASP.NET génère dynamiquement une classe ProfileCommon qui hérite de ce type et la place dans la propriété Profile du HttpContext actuel.
automaticSaveEnabled	Attribut Boolean facultatif. Indique si le profil utilisateur est automatiquement enregistré à la fin de l'exécution d'une page ASP.NET. Si la valeur est true, le profil utilisateur est automatiquement enregistré à la fin de l'exécution d'une page ASP.NET. L'objet ProfileModule enregistre un profil utilisateur uniquement si le module détecte que le profil a été modifié. En d'autres termes, la propriété IsDirty est true. Pour plus d'informations, consultez Vue d'ensemble des propriétés du profil ASP.NET. La valeur par défaut est true.

Éléments enfants

Élément	Description
properties	Élément requis. Définit une collection de propriétés et de groupes de propriétés du profil utilisateur.
providers	Élément facultatif. Définit une collection de fournisseurs de profils.

properties

Élément requis.

Définit une collection de propriétés et de groupes de propriétés du profil utilisateur.

providers

Élément facultatif.

Définit une collection de fournisseurs de profils.

Éléments parents

Élément	Description
configuration	Spécifie l'élément racine requis 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.

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.

Configuration par défaut

L'élément profile par défaut est configuré dans le fichier Machine.config de la version 2.0 du .NET Framework.

<profile>
  <providers>
        <add name="AspNetSqlProfileProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Profile.SqlProfileProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> 
  </providers>
</profile>

Exemple

L'exemple de code suivant montre comment configurer le fichier Web.config d'une application ASP.NET pour qu'elle utilise un fournisseur SqlProfileProvider.

<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"
             applicationName="SampleApplication"
             enablePasswordRetrieval="true"
             enablePasswordReset="true"
             passwordFormat="Encrypted"
             requiresQuestionAndAnswer="true" />
      </providers>
    </membership>

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

      <properties>
        <add name="ZipCode" />
        <add name="CityAndState" />
      </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

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

Attributs et éléments

Attributs

Éléments enfants

Éléments parents

Notes

Configuration par défaut

Exemple

Informations sur les éléments

Voir aussi

Tâches

Concepts

Référence

Autres ressources

Ressources supplémentaires