Comment : définir le mode d'affichage d'une page WebPart

Mise à jour : novembre 2007

La technologie WebPart fournit divers modes d'affichage de la page qui permettent aux utilisateurs d'exécuter des personnalisations sur une page Web ; toutefois, il incombe au développeur de pages de décider des modes d'affichage dont l'utilisateur final aura besoin et de les mettre à sa disposition. Cette rubrique montre comment créer des boutons de design et de navigation simples qui définissent la propriété DisplayMode de l'instance WebPartManager. En mode Design, l'utilisateur peut faire glisser des contrôles WebPart pour modifier la disposition de la page, alors qu'en mode de navigation, seules les fonctionnalités de navigation Web standard sont disponibles. Pour obtenir les descriptions des autres modes d'affichage de la page, consultez Modes d'affichage des pages WebPart.

Pour créer les boutons de design et de navigation ainsi que leurs événements Click

1. Créez une page ASP.NET qui inclut un contrôle WebPartManager, quelques contrôles WebPartZone et des contrôles Web standard à l'intérieur des zones. Pour obtenir une assistance pas à pas, consultez Procédure pas à pas : création d'une page WebPart.

2. Créez deux contrôles Button à l'extérieur des zones, un avec la valeur de design affectée à ses propriétés ID et Text, et l'autre avec la valeur de navigation affectée aux deux propriétés.

3. Placez les gestionnaires d'événements Click pour les deux boutons dans un bloc <script> dans l'en-tête de la page, ou dans la page de codes si vous utilisez un fichier code-behind. Votre code doit ressembler à l'exemple suivant :

   Protected Sub Design_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles Design.Click
     ' Get the current WebPartManager instance.
     Dim mgr As WebPartManager
     mgr = WebPartManager.GetCurrentWebPartManager(Page)
   
     ' Set the display mode.
     mgr.DisplayMode = mgr.SupportedDisplayModes.Item("Design")
   End Sub
   
   Protected Sub Browse_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles Browse.Click
     ' Get the current WebPartManager instance.
     Dim mgr As WebPartManager
     mgr = WebPartManager.GetCurrentWebPartManager(Page)
   
     ' Set the display mode.
     mgr.DisplayMode = mgr.SupportedDisplayModes.Item("Browse")
   End Sub
   

   protected void design_Click(object sender, EventArgs e)
   {
     // Get the current WebPartManager instance.
     WebPartManager mgr = WebPartManager.GetCurrentWebPartManager(Page);
   
     // Change the page display mode.
     mgr.DisplayMode = mgr.SupportedDisplayModes["Design"];
   }
   
   protected void browse_Click(object sender, EventArgs e)
   {
     // Get the current WebPartManager instance.
     WebPartManager mgr = WebPartManager.GetCurrentWebPartManager(Page);
   
     // Change it back.
     mgr.DisplayMode = mgr.SupportedDisplayModes["Browse"];
   }
   

4. Générez et exécutez la page. Lorsque vous cliquez sur le bouton de design, vous devez être en mesure de faire glisser les contrôles entre les zones ; lorsque vous cliquez sur le bouton de navigation, les fonctionnalités de glisser-déplacer sont désactivées.

Voir aussi

Tâches

Procédure pas à pas : modification des modes d'affichage sur une page WebPart

Concepts

Modes d'affichage des pages WebPart

Référence

DisplayMode

WebPartManager