Procedura: impostare la modalità di visualizzazione di una pagina Web part

Aggiornamento: novembre 2007

La tecnologia Web part offre diverse modalità di visualizzazione della pagina che consentono agli utenti di eseguire la personalizzazione in una pagina Web. Tuttavia, è responsabilità dello sviluppatore della pagina decidere quali modalità di visualizzazione saranno necessarie per l'utente finale e come renderle disponibili. In questo argomento verrà illustrato come creare semplici pulsanti di "progettazione" e "visualizzazione" che impostano la proprietà DisplayMode dell'istanza WebPartManager. In modalità progettazione l'utente può trascinare i controlli Web part per modificare il layout della pagina, mentre in modalità visualizzazione è disponibile solo la funzionalità di esplorazione del Web standard. Per le descrizioni delle altre modalità di visualizzazione della pagina, vedere Modalità di visualizzazione di pagine Web part.

Per creare i pulsanti di progettazione e visualizzazione e gli eventi Click corrispondenti

1. Creare una pagina ASP.NET che include un controllo WebPartManager, alcuni controlli WebPartZone e alcuni controlli Web standard nelle aree. Per istruzioni dettagliate, vedere Procedura dettagliata: creazione di una pagina Web part.

2. Creare due controlli Button all'esterno delle aree, uno con le proprietà ID e Text impostate su "Design" e uno con entrambe le proprietà impostate su "Browse".

3. Inserire i gestori eventi Click per i due pulsanti in un blocco <script> nell'intestazione della pagina o nella tabella codici se si sta utilizzando un file code-behind. Il codice sarà analogo a quello riportato nell'esempio seguente.

   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. Generare ed eseguire la pagina. Quando si fa clic sul pulsante di progettazione, dovrebbe essere possibile trascinare i controlli tra aree; quando si fa clic sul pulsante di visualizzazione la funzionalità di trascinamento selezione è disattivata.

Vedere anche

Attività

Procedura dettagliata: modifica delle modalità di visualizzazione in una pagina Web part

Concetti

Modalità di visualizzazione di pagine Web part

Riferimenti

DisplayMode

WebPartManager