Partager via

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

  • Article

Mise à jour : novembre 2007

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.

configuration, élément (Schéma des paramètres généraux)
  system.web, élément (Schéma des paramètres ASP.NET)
    webParts, élément (Schéma des paramètres ASP.NET)

<webParts enableExport="true|false">
   <personalization...>...</personalization>
   <transformers>...</transformers >
</webParts>

Attributs et éléments

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

Attributs

Attribut

Description

enableExport

Attribut Boolean facultatif.

Active l'exportation de données de contrôle vers un fichier de description XML.

La valeur par défaut est false.

Éléments enfants

Élément

Description

personalization

Élément facultatif.

Spécifie le fournisseur de personnalisations WebParts et définit les autorisations de personnalisation des WebParts.

transformers

Élément facultatif.

Définit une collection d'objets TransformerInfo.

Éléments parents

Élément

Description

configuration

Élément racine obligatoire de 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.

Notes

Configuration par défaut

L'élément webParts par défaut suivant est configuré dans le fichier Web.config racine dans le .NET Framework version 2.0.

<webParts>
  <personalization>
    <providers>
      <add connectionStringName="LocalSqlServer"
        name="AspNetSqlPersonalizationProvider" 
        type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider, System.Web, 
        Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    </providers>

    <authorization>
      <deny users="*" verbs="enterSharedScope" />
      <allow users="*" verbs="modifyState" />
    </authorization>

  </personalization>

  <transformers>
    <add name="RowToFieldTransformer"
      type="System.Web.UI.WebControls.WebParts.RowToFieldTransformer" />
    <add name="RowToParametersTransformer" 
      type="System.Web.UI.WebControls.WebParts.RowToParametersTransformer" />
  </transformers>
</webParts>

Exemple

L'exemple suivant montre comment spécifier de manière déclarative les valeurs de la section webParts.

<webParts>
  <personalization defaultProvider="AspNetSqlPersonalizationProvider">
    <providers>
      <add name="AspNetSqlPersonalizationProvider"
        type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
        connectionStringName="LocalSqlServer" applicationName="/" />
    </providers>
    <authorization>
      <deny users="*" verbs="enterSharedScope" />
      <allow users="*" verbs="modifyState" />
    </authorization>
  </personalization>
</webParts>

Les fournisseurs peuvent être définis uniquement au niveau de l'application.

Informations sur les éléments

Gestionnaire de section de configuration

System.Web.Configuration.WebPartsSection

Membre de configuration

SystemWebSectionGroup.WebParts

Emplacements configurables

Machine.config

Web.config de niveau racine

Web.config de niveau application

Web.config de niveau répertoire virtuel ou physique

Configuration requise

IIS version 6.0

.NET Framework version 2.0

Visual Studio 2005

Voir aussi

Tâches

Comment : configurer des répertoires spécifiques à l'aide des paramètres d'emplacement

Comment : verrouiller des paramètres de configuration ASP.NET

Concepts

Vue d'ensemble de la configuration ASP.NET

Scénarios de configuration ASP.NET

Sécurisation de la configuration ASP.NET

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)

personalization, élément de webParts (Schéma des paramètres ASP.NET)

transformers, élément de webParts (Schéma des paramètres ASP.NET)

WebPartsSection

WebPartsPersonalization

WebPartsPersonalizationAuthorization

System.Configuration

System.Web.Configuration

Autres ressources

Paramètres généraux de configuration (ASP.NET)

Paramètres de configuration ASP.NET

Administration de sites Web ASP.NET

API de configuration ASP.NET