Comment : créer des propriétés personnalisables dans un contrôle WebPart

Mise à jour : novembre 2007

L'une des principales fonctionnalités du jeu de contrôles WebPart est la capacité de personnaliser des contrôles sur une page. Cela permet à l'utilisateur final de définir des valeurs de propriété qui restent associées à cet utilisateur chaque fois qu'il affiche la page.

Les développeurs de pages peuvent activer la personnalisation en appliquant l'attribut Personalizable à une propriété publique d'un contrôle WebPart. Le contrôle peut être un contrôle personnalisé hérité de WebPart, un contrôle utilisateur ou tout autre contrôle sur lequel vous pouvez créer une propriété, tant qu'il réside dans une zone WebPartZone et qu'il existe un contrôle WebPartManager quelque part sur la page.

Remarque :

Pour mettre en œuvre cette procédure, vous avez besoin d'un site Web ASP.NET capable d'identifier les utilisateurs individuels. Si vous possédez un site de ce type configuré, vous pouvez l'utiliser. Sinon, pour plus d'informations sur la création d'un répertoire virtuel, consultez Comment : créer et configurer des répertoires virtuels dans IIS 5.0 et 6.0. Vous avez également besoin d'un fournisseur de personnalisations et d'une base de données configurés. La personnalisation des contrôles WebPart est activée par défaut ; si Microsoft SQL Server Express (SSE) est installé, aucune configuration n'est exigée. SSE est disponible avec Microsoft Visual Studio 2005 en tant que partie facultative de l'installation ou en tant que téléchargement libre sur Microsoft.com. Sinon, si vous utilisez une version complète de SQL Server, consultez Création et configuration de la base de données des services d'application pour SQL Server ou, pour une solution de stockage ou de base de données autre que SQL, consultez Implémentation d'un fournisseur d'appartenances.

Pour activer la personnalisation sur un contrôle

1. Placez le contrôle à personnaliser à l'intérieur d'une zone WebPartZone sur une page WebPart ASP.NET. La page doit contenir un contrôle WebPartManager pour que les contrôles WebPart fonctionnent. Pour plus d'informations, consultez Procédure pas à pas : création d'une page WebPart.

2. En haut du bloc de code où la propriété que vous souhaitez personnaliser est définie, ajoutez l'attribut Personalizable, comme illustré dans l'exemple suivant.

   <Personalizable()>
   Property SampleProperty() As String
     Get…
     Set…
   End Property
   

   [Personalizable]
   Public string SampleProperty
   {
     Get{…}
     Set{…}
   }
   

Voir aussi

Concepts

Vue d'ensemble de la personnalisation des WebParts

Configuration requise pour l'utilisation de la personnalisation de WebParts

Référence

System.Web.UI.WebControls.WebParts

Personalizable

Autres ressources

Contrôles WebPart ASP.NET

Personnalisation des WebParts