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

Article
09/04/2008

Mise à jour : novembre 2007

Ajoute une instance de fournisseur de profils à la collection de fournisseurs de profils utilisateur.

Cet élément est une nouveauté de .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)
      providers, élément de profile (Schéma des paramètres ASP.NET)
        add, élément de providers pour profile (Schéma des paramètres ASP.NET)

<add 
    name="provider name" 
    type="fully qualified type reference"
    connectionStringName="connection string identifier"
    commandTimeout="number of seconds before a command times out"
    description="description of the provider instance"
    applicationName="application name for stored profile information" />

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 l'instance de fournisseur. Il s'agit de la valeur utilisée pour l'attribut defaultProvider de l'élément <profile> pour identifier l'instance de fournisseur comme fournisseur de profils par défaut. L'élément name du fournisseur est également utilisé pour indexer le fournisseur dans la collection Providers.
type	Attribut String requis. Spécifie le type qui implémente la classe de base abstraite ProfileProvider.
connectionStringName	Attribut String requis. Spécifie le nom d'une chaîne de connexion définie dans l'élément < connectionStrings >. La chaîne de connexion spécifiée sera utilisée par le fournisseur qui est ajouté.
applicationName	Attribut String facultatif. Spécifie le nom de l'application sous laquelle les données de profil sont stockées dans la source de données. Le nom d'application permet à plusieurs applications ASP.NET d'utiliser la même base de données sans rencontrer de données de profil en double pour des applications différentes. Plusieurs applications ASP.NET peuvent également utiliser les mêmes informations de profil en spécifiant le même nom d'application. Les fournisseurs de profils inclus avec le .NET Framework utilisent la valeur ApplicationVirtualPath pour la propriété ApplicationName si cet attribut n'est pas spécifié.
commandTimeout	Attribut Int32 facultatif. Spécifie le nombre de secondes avant l'expiration du délai imparti à une commande envoyée à la source de données d'appartenance. Ce délai est utilisé par le fournisseur SQL lors de la création d'objets SqlCommand. Par défaut, cet attribut n'est pas défini dans la configuration ASP.NET. Par conséquent, la valeur par défaut ADO.NET de 30 secondes est utilisée. Si cet attribut est défini, le fournisseur SQL utilise la valeur du délai d'attente configurée pour toutes les commandes SQL envoyées à la base de données. La valeur par défaut est 30 (valeur par défaut ADO.NET).
description	Attribut String facultatif. Spécifie une description de l'instance de fournisseur de profils.

Éléments enfants

Aucun

Éléments parents

Élément	Description
providers	Définit une collection de fournisseurs de profils pour le profil utilisateur.
profile	Configure le profil utilisateur pour une application.
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.

Notes

Vous pouvez inclure des attributs supplémentaires dans l'élément add pour une implémentation de fournisseur de profils personnalisée. Pour un exemple, consultez Comment : créer et exécuter l'exemple de fournisseur de profils.

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.

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

Exemple

L'exemple de code suivant montre comment créer un fichier Web.config pour une application ASP.NET configurée pour utiliser 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	ProfileSection.Providers
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 providers pour profile (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