如何：设置 Web 部件页的显示模式

更新：2007 年 11 月

Web 部件技术提供了多种使用户能够对网页执行自定义的页面显示模式；但是，将由页面开发人员负责确定最终用户需要的显示模式并提供这些显示模式。本主题演示了如何创建简单的“Design”（设计）和“Browse”（浏览）按钮，以设置 WebPartManager 实例的 DisplayMode 属性。在设计模式下，用户可以通过拖动 Web 部件控件来编辑页面布局，而在浏览模式下，用户只能使用标准的 Web 浏览功能。有关其他页面显示模式的说明，请参见 Web 部件页显示模式。

创建“Design”和“Browse”按钮及其 Click 事件

1. 创建一个 ASP.NET 页，其在区域中包括一个 WebPartManager 控件，一些 WebPartZone 控件以及一些标准 Web 控件。有关分步帮助，请参见演练：创建 Web 部件页。

2. 在区域之外创建两个 Button 控件，并将其中一个控件的 ID 和 Text 属性都设置为“Design”，同时将另一个控件的这两个属性都设置为“Browse”。

3. 将这两个按钮的 Click 事件处理程序置于页开头的 <script> 块中，或者如果使用的是代码隐藏文件，则将它们置于代码页中。这些代码应类似于下面的示例。

   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. 生成并运行此页。当您单击“Design”（设计）按钮时，应该能够在区域之间拖动控件；当您单击“Browse”（浏览）时，将禁用拖放功能。

请参见

任务

演练：更改 Web 部件页上的显示模式

概念

Web 部件页显示模式

参考

DisplayMode

WebPartManager