add, élément de providers pour webParts (Schéma des paramètres ASP.NET)
[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]
Spécifie le nom du fournisseur et la classe qui l'implémentent.
<add name="String"
type="String"
connectionStringName="String"
applicationName="String"
commandTimeout="number"/>
Attributs et éléments
Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.
Attributs
Attribut |
Description |
|---|---|
applicationName |
Attribut String facultatif. Spécifie le nom de l'application pour laquelle stocker et récupérer des informations de personnalisation. |
connectionStringName |
Attribut String requis. Spécifie la chaîne spécifique au fournisseur SQL utilisé pour établir la connexion à la base de données. |
commandTimeout |
Attribut Int32 facultatif. Spécifie le nombre de secondes avant l'expiration du délai imparti à une commande émise dans la source de données de personnalisation WebParts. Ce délai est utilisé par le fournisseur SQL lors de la création d'objets SqlCommand. Cet attribut n'est pas défini par défaut dans la configuration ASP.NET. En conséquence, 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 générées dans la base de données. |
name |
Attribut String requis. Nom convivial du fournisseur. |
type |
Attribut String requis. Spécifie une référence d'assembly qualifiée complète à une classe qui implémente la classe PersonalizationProvider de base. Selon l'emplacement du code qui contient le fournisseur, il peut s'agir d'une référence partielle (par exemple, uniquement Namespace.ClassName ou Namespace.Classname, AssemblyName) d'une référence d'assembly qualifiée complète à une classe qui implémente la classe PersonalizationProvider de base. |
Éléments enfants
Aucun
Éléments parents
Élément |
Description |
|---|---|
configuration |
É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 pour les paramètres de configuration ASP.NET dans un fichier de configuration. Contient des éléments de configuration qui configurent les applications Web ASP.NET et contrôlent le comportement des applications. |
webParts |
Vous permet de spécifier un fournisseur de personnalisations WebPart, de définir des autorisations de personnalisation et d'ajouter des classes personnalisées qui étendent la classe WebPartTransformer pour une utilisation par les connexions WebPart. |
personalization |
Spécifie le fournisseur de personnalisations WebParts et définit les autorisations de personnalisation des WebParts. |
providers |
Définit les fournisseurs de personnalisations WebPart pour l'application Web en cours. |
Notes
Il est important de savoir que la personnalisation échoue si votre application Web ne s'exécute pas au niveau de confiance par défaut de Moyenne ou supérieur (vous pouvez définir des niveaux de confiance personnalisés dans un fichier Web.config à l'aide de l'élément <trust level="" />). Les classes PersonalizationAdministration et SqlPersonalizationProvider vérifient le niveau de confiance de Low lorsqu'elles sont initialisées. Si vous configurez votre application pour l'exécuter à un niveau de confiance Low et que vous utilisez le SqlPersonalizationProvider par défaut pour gérer les données de personnalisation de votre application, la première tentative de l'application pour accéder aux données de personnalisation échoue parce qu'un processus de travail ASP.NET s'exécutant à un niveau de confiance basse n'a pas les autorisations nécessaires pour appeler dans plusieurs classes de l'espace de noms System.Data.SqlClient.
Configuration par défaut
L'élément add par défaut suivant est configuré dans le fichier Web.config racine de .NET Framework version 2.0.
<providers>
<add name="AspNetSqlPersonalizationProvider"
type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
connectionStringName="LocalSqlServer"
/>
</providers>
Exemple
L'exemple suivant montre comment ajouter un fournisseur.
<webParts>
<personalization defaultProvider="AspNetSqlPersonalizationProvider">
<providers>
<add name="AspNetSqlPersonalizationProvider"
type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
connectionStringName="LocalSqlServer"
applicationName="/" />
</providers>
</personalization>
</webParts>
Les fournisseurs peuvent être définis uniquement au niveau de l'ordinateur, du site et de l'application.
Informations sur les éléments
Gestionnaire de section de configuration |
|
Membre de configuration |
|
Emplacements configurables |
Machine.config Web.config de niveau racine Web.config de niveau application |
Configuration requise |
IIS 5.0, 5.1 et 6.0 .NET Framework 2.0 Visual Studio 2005 |
Voir aussi
Tâches
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Référence
system.web, élément (Schéma des paramètres ASP.NET)
configuration, élément (Schéma des paramètres généraux)
clear, élément de providers pour webParts (Schéma des paramètres ASP.NET)
remove, élément de providers pour webParts (Schéma des paramètres ASP.NET)
Concepts
ASP.NET Configuration Overview
Autres ressources
Paramètres généraux de configuration (ASP.NET)
Paramètres de configuration ASP.NET