Como: Defina o modo de exibição de uma página de Web Parts

A tecnologia Web Parts fornece uma variedade de modos de exibição de página que permitem aos usuários executar personalizações em um página da Web; no entanto, é responsabilidade do desenvolvedor de páginas decidir quais modos de exibição o usuário final necessitará e torná-los disponíveis.Este tópico mostra como criar botões simples "estruturar" e "procurar" que definem a propriedade DisplayMode da instância WebPartManager.No modo de design, o usuário pode arrastar controles de Web Parts para editar o layout da página, enquanto no modo de procura apenas funcionalidade de navegação padrão está disponível.Para obter descrições da outros modos de exibição de página, consulte Modos de Exibição de Páginas Web Parts.

Para criar os botões estrutura e procurar e seus eventos Click

1. Crie um página ASP.NET que inclui um controle WebPartManager, alguns controles WebPartZone e alguns controles de Web padrão dentro das zonas.Para obter assistência passo a passo, consulte Demonstra Passo a passo: Criação de uma página de Web Parts.

2. Criar dois controles Button fora de zonas, um com suas propriedades ID e Text ambas definidas como "estruturar" e outra com ambas as propriedades definidas para "procurar".

3. Coloque os manipuladores de eventos Click para os dois botões em um bloco <script> no topo da página, ou página de código se você estiver usando um arquivo code-behind.Seu código deve ter aparência do exemplo a seguir.

   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. Criar e executar a página.Quando você clica no botão Estruturar, você deve ser poder arrastar controles entre zonas; quando você clicar em Procurar, a funcionalidade arrastar-e-soltar está desabilitada.

Consulte também

Tarefas

Demonstra Passo a passo: Alterando modos de exibição em uma página de Web Parts

Conceitos

Modos de Exibição de Páginas Web Parts

Referência

DisplayMode

WebPartManager