WebPartZoneBase 类

定义

用作充当 WebPart(或者其他服务器或用户)控件的容器的所有区域控件的基类。Serves as the base class for all zone controls that act as containers for WebPart (or other server or user) controls.

public ref class WebPartZoneBase abstract : System::Web::UI::WebControls::WebParts::WebZone, System::Web::UI::IPostBackEventHandler
public abstract class WebPartZoneBase : System.Web.UI.WebControls.WebParts.WebZone, System.Web.UI.IPostBackEventHandler
type WebPartZoneBase = class
    inherit WebZone
    interface IPostBackEventHandler
Public MustInherit Class WebPartZoneBase
Inherits WebZone
Implements IPostBackEventHandler
继承
派生
实现

示例

下面的代码示例演示如何使用 WebPartZoneBase 类。The following code example demonstrates the use of the WebPartZoneBase class. 该代码演示如何在 Web 部件页中以声明方式使用派生类 WebPartZone来包含 WebPart 控件。The code shows how a derived class, WebPartZone, is used declaratively in a Web Parts page to contain WebPart controls. 此代码示例包含四个部分:前三个部分说明了代码文件,第四个部分说明了如何运行代码。The code example has four sections: the first three sections describe the code files, and the fourth explains how to run the code.

此代码示例的第一部分是用户控件,该控件使用户能够将页面切换到不同的显示模式。The first part of the code example is a user control that enables users to switch the page into different display modes. 若要详细了解 Web 部件显示模式以及此控件中代码的说明,请参阅演练:更改 Web 部件页上的显示模式For more information on Web Parts display modes and a description of the code in this control, see Walkthrough: Changing Display Modes on a Web Parts Page.

<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }
    
  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text="&nbsp;Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>
<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
  ' Use a field to reference the current WebPartManager.
  Dim _manager As WebPartManager

  Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
    AddHandler Page.InitComplete, AddressOf InitComplete
  End Sub

  Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
      
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
      
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In _manager.SupportedDisplayModes
      Dim modeName As String = mode.Name
      ' Make sure a mode is enabled before adding it.
      If mode.IsEnabled(_manager) Then
        Dim item As New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next mode
      
    ' If shared scope is allowed for this user, display the scope-switching
    ' UI and select the appropriate radio button for the current user scope.
    If _manager.Personalization.CanEnterSharedScope Then
      Panel2.Visible = True
      If _manager.Personalization.Scope = PersonalizationScope.User Then
        RadioButton1.Checked = True
      Else
        RadioButton2.Checked = True
      End If
    End If
   
  End Sub

  ' Change the page to the selected display mode.
  Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue   
    Dim mode As WebPartDisplayMode = _
      _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
      _manager.DisplayMode = mode
    End If

  End Sub
   
  ' Set the selected item equal to the current display mode.
  Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
    Dim items As ListItemCollection = DisplayModeDropdown.Items
    Dim selectedIndex As Integer = _
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
    DisplayModeDropdown.SelectedIndex = selectedIndex

  End Sub

  ' Reset all of a user's personalization data for the page.
  Protected Sub LinkButton1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    _manager.Personalization.ResetPersonalizationState()
    
  End Sub

  ' If not in User personalization scope, toggle into it.
  Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.Scope = PersonalizationScope.Shared Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub
   
  ' If not in Shared scope, and if user is allowed, toggle the scope.
  Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.CanEnterSharedScope AndAlso _
      _manager.Personalization.Scope = PersonalizationScope.User Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub

</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text="&nbsp;Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" />
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

此代码示例的第二部分是一个代码旁置文件,其中包含用于处理主网页事件的代码。The second part of the code example is a code-beside file that contains the code to handle events for the main Web page. 此文件中的代码演示如何以编程方式使用某些键 WebPartZoneBase 成员。The code in this file shows how to work with some of the key WebPartZoneBase members programmatically.

using System;
using System.Text;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

public partial class WebPartZoneBase_overview : System.Web.UI.Page
{
  protected void Page_Load(Object sender, EventArgs e)
  {
    Label1.Text = DateTime.Now.ToLongDateString();
    Label2.Text = String.Empty;
  }

  protected void Button1_Click(object sender, EventArgs e)
  {
    if (WebPartZone2.VerbButtonType == ButtonType.Button)
      WebPartZone2.VerbButtonType = ButtonType.Link;
    else
      WebPartZone2.VerbButtonType = ButtonType.Button;
  }

  protected void Button2_Click(object sender, EventArgs e)
  {
    if (WebPartZone1.LayoutOrientation == Orientation.Vertical)
      WebPartZone1.LayoutOrientation = Orientation.Horizontal;
    else
      WebPartZone1.LayoutOrientation = Orientation.Vertical;
    Page_Load(sender, e);
  }

  protected void Button3_Click(object sender, EventArgs e)
  {
    StringBuilder builder = new StringBuilder();
    builder.AppendLine(@"<strong>WebPartZone1 WebPart IDs</strong><br />");
    foreach (WebPart part in WebPartZone1.WebParts)
    {
      builder.AppendLine("ID: " + part.ID 
                          + "; Type:  " + part.GetType() 
                          + @"<br />");
    }
    Label2.Text = builder.ToString();
    Label2.Visible = true;
  }

  protected void Button4_Click(object sender, EventArgs e)
  {
    StringBuilder builder = new StringBuilder();
    builder.AppendLine(@"<strong>WebPartZone1 DisplayTitle Property</strong><br />");
    builder.AppendLine(WebPartZone1.DisplayTitle + @"<br />");
    Label2.Text = builder.ToString();
    Label2.Visible = true;
  }
}
Imports System.Text
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Partial Public Class WebPartZoneBase_overview

  Inherits System.Web.UI.Page

  Protected Sub Page_Load(ByVal sender As [Object], ByVal e As EventArgs) 
    Label1.Text = DateTime.Now.ToLongDateString()
    Label2.Text = String.Empty
  End Sub
  
  Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs) 
    If WebPartZone2.VerbButtonType = ButtonType.Button Then
        WebPartZone2.VerbButtonType = ButtonType.Link
    Else
        WebPartZone2.VerbButtonType = ButtonType.Button
    End If
  End Sub
 
  Protected Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs) 
    If WebPartZone1.LayoutOrientation = Orientation.Vertical Then
        WebPartZone1.LayoutOrientation = Orientation.Horizontal
    Else
        WebPartZone1.LayoutOrientation = Orientation.Vertical
    End If
    Page_Load(sender, e)
  End Sub 
  
  Protected Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs) 
    Dim builder As New StringBuilder()
    builder.AppendLine("<strong>WebPartZone2 WebPart IDs</strong><br />")
    Dim part As WebPart
    For Each part In  WebPartZone1.WebParts
      builder.AppendLine("ID: " + part.ID + "; Type: " _
                          + part.GetType().ToString() _
                          + "<br />")
    Next part
    Label2.Text = builder.ToString()
    Label2.Visible = True
  End Sub 

  Protected Sub Button4_Click(ByVal sender As Object, ByVal e As EventArgs)
    Dim builder As New StringBuilder()
    builder.AppendLine("<strong>WebPartZone1 DisplayTitle Property</strong><br />")
    builder.AppendLine(WebPartZone1.DisplayTitle + "<br />")
    Label2.Text = builder.ToString()
    Label2.Visible = True
  End Sub

End Class

此代码示例的第三部分是包含 WebPartZone 控件的网页,这些控件表现自基 WebPartZoneBase 类的行为和区域中包含的 WebPart 控件。The third part of the code example is the Web page that contains the WebPartZone controls that exhibit behavior from the base WebPartZoneBase class, and WebPart controls contained in the zones.

<%@ Page Language="C#" 
  Codefile="webpartzonebase_overview.cs"
  Inherits="WebPartZoneBase_overview"  %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>WebPartZoneBase Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="WebPartManager1" Runat="server" />
      <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
      <table width="75%">
        <tr>
          <td>
            <asp:WebPartZone 
              ID="WebPartZone1" 
              Runat="server"
              LayoutOrientation="Vertical" >
              <EditVerb Text="Edit WebPart" />
              <SelectedPartChromeStyle BackColor="LightBlue" />
              <ZoneTemplate>
                <asp:BulletedList 
                  ID="BulletedList1" 
                  Runat="server"
                  DisplayMode="HyperLink" 
                  Title="Favorite Links" >
                  <asp:ListItem Value="http://msdn.microsoft.com">
                    MSDN
                  </asp:ListItem>
                  <asp:ListItem Value="http://www.asp.net">
                    ASP.NET
                  </asp:ListItem>
                  <asp:ListItem Value="http://www.msn.com">
                    MSN
                  </asp:ListItem>
                </asp:BulletedList>
                <asp:Calendar ID="Calendar1" Runat="server" 
                  Title="My Calendar" />
              </ZoneTemplate>
            </asp:WebPartZone>
          </td>
          <td valign="top" align="right">
            <asp:WebPartZone 
              ID="WebPartZone2"
              Runat="server" 
              DragHighlightColor="#00ff00"
              AllowLayoutChange="true"
              EmptyZoneText="Add WebParts to this empty Zone."
              BorderWidth="2"
              BorderColor="DarkBlue"
              BorderStyle="Dashed" 
              MenuLabelText="Verbs Menu" 
              MenuPopupImageUrl="label.gif" >
              <VerbStyle Font-Italic="true" />
              <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
              <MenuLabelHoverStyle Font-Bold="true" />
              <MenuVerbHoverStyle BackColor="LightGrey" />
              <MenuVerbStyle Font-Italic="true" /> 
              <ZoneTemplate>
                <asp:Label ID="Label1" Runat="server" Title="Date" />
              </ZoneTemplate>
            </asp:WebPartZone>
          </td>
        </tr>
        <tr>
          <td>
            <asp:EditorZone ID="EditorZone1" Runat="server">
              <ZoneTemplate>
                <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
                  Runat="server" />
                <asp:LayoutEditorPart ID="LayoutEditorPart1" 
                  Runat="server" />
              </ZoneTemplate>
            </asp:EditorZone>      
          </td>
        </tr>
      </table>
    </div>
    <asp:Button ID="Button1" Runat="server" 
      Width="200" Text="Toggle WebPartZone2 Buttons" 
      OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" Runat="server" 
      Width="200"  Text="Toggle Layout Orientation" 
      OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" Runat="server" 
      Width="200" Text="List WebPartZone1 WebParts" 
      OnClick="Button3_Click" />
    <br />
    <asp:Button ID="Button4" Runat="server" 
      Width="200" Text="WebPartZone1 Display Title" 
      OnClick="Button4_Click" />
    <br />
    <asp:Label ID="Label2" Runat="server" Visible="false" />
    </form>
</body>
</html>
<%@ Page Language="VB" 
  Codefile="webpartzonebase_overview.vb"
  Inherits="WebPartZoneBase_overview"  %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>WebPartZoneBase Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="WebPartManager1" Runat="server" />
      <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
      <table width="75%">
        <tr>
          <td>
            <asp:WebPartZone 
              ID="WebPartZone1" 
              Runat="server"
              LayoutOrientation="Vertical" >
              <EditVerb Text="Edit WebPart" />
              <SelectedPartChromeStyle BackColor="LightBlue" />
              <ZoneTemplate>
                <asp:BulletedList 
                  ID="BulletedList1" 
                  Runat="server"
                  DisplayMode="HyperLink" 
                  Title="Favorite Links" >
                  <asp:ListItem Value="http://msdn.microsoft.com">
                    MSDN
                  </asp:ListItem>
                  <asp:ListItem Value="http://www.asp.net">
                    ASP.NET
                  </asp:ListItem>
                  <asp:ListItem Value="http://www.msn.com">
                    MSN
                  </asp:ListItem>
                </asp:BulletedList>
                <asp:Calendar ID="Calendar1" Runat="server" 
                  Title="My Calendar" />
              </ZoneTemplate>
            </asp:WebPartZone>
          </td>
          <td valign="top" align="right">
            <asp:WebPartZone 
              ID="WebPartZone2"
              Runat="server" 
              DragHighlightColor="#00ff00"
              AllowLayoutChange="true"
              EmptyZoneText="Add WebParts to this empty Zone."
              BorderWidth="2"
              BorderColor="DarkBlue"
              BorderStyle="Dashed" 
              MenuLabelText="Verbs Menu" 
              MenuPopupImageUrl="label.gif" >
              <VerbStyle Font-Italic="true" />
              <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
              <MenuLabelHoverStyle Font-Bold="true" />
              <MenuVerbHoverStyle BackColor="LightGrey" />
              <MenuVerbStyle Font-Italic="true" /> 
              <ZoneTemplate>
                <asp:Label ID="Label1" Runat="server" Title="Date" />
              </ZoneTemplate>
            </asp:WebPartZone>
          </td>
        </tr>
        <tr>
          <td>
            <asp:EditorZone ID="EditorZone1" Runat="server">
              <ZoneTemplate>
                <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
                  Runat="server" />
                <asp:LayoutEditorPart ID="LayoutEditorPart1" 
                  Runat="server" />
              </ZoneTemplate>
            </asp:EditorZone>      
          </td>
        </tr>
      </table>
    </div>
    <asp:Button ID="Button1" Runat="server" 
      Width="200" Text="Toggle WebPartZone2 Buttons" 
      OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" Runat="server" 
      Width="200"  Text="Toggle Layout Orientation" 
      OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" Runat="server" 
      Width="200" Text="List WebPartZone1 WebParts" 
      OnClick="Button3_Click" />
    <br />
    <asp:Button ID="Button4" Runat="server" 
      Width="200" Text="WebPartZone1 Display Title" 
      OnClick="Button4_Click" />
    <br />
    <asp:Label ID="Label2" Runat="server" Visible="false" />
    </form>
</body>
</html>

在浏览器中加载网页。Load the Web page in a browser. 使用 "显示模式" 下拉列表控件将页面切换到设计模式,单击 "WebPart" 控件,并尝试将其拖动到可见区域之间。Use the Display Mode drop-down list control to switch the page into design mode, click the WebPart controls, and try dragging them between the visible zones. 单击页面上的某些按钮,查看使用 WebPartZoneBase 类的各种成员的效果。Click some of the buttons on the page to see the effect of using various members of the WebPartZoneBase class. 接下来,将页面切换到编辑模式。Next, switch the page to edit mode. 请确保 WebPart 控件位于 WebPartZone2中,单击控件标题栏上的谓词菜单,然后单击 "编辑" 以编辑控件。Make sure a WebPart control is positioned in WebPartZone2, click the verbs menu on the control's title bar, and click Edit to edit the control. 完成该控件的编辑后,编辑另一个区域中的某个控件。Finish editing that control, and then edit one of the controls in the other zone. 执行这些步骤时,请注意控件的 UI 样式和区域之间的差异,它们是使用 WebPartZoneBase 类的各种成员的效果。As you carry out these steps, notice the differences in the UI styles of the controls and the zones, which are the effect of using the various members of the WebPartZoneBase class.

注解

在 Web 部件控件集中,区域是一个复合控件,呈现为 HTML 表,其中包含网页的定义区域中的其他控件。In the Web Parts control set, a zone is a composite control, rendered as an HTML table, that contains other controls in a defined region of a Web page. WebPartZoneBase 类是继承自基 WebZone 类的区域,它为包含 WebPart 控件、服务器控件和用户控件的派生区域提供一组基本行为。The WebPartZoneBase class is a zone that inherits from the base WebZone class and provides a base set of behaviors for derived zones that contain WebPart controls, server controls, and user controls. 使用 WebPart (和其他服务器)控件的 WebPartZoneBase 区域的组合构成了 Web 部件应用程序的主要 UI,这是用户在大多数时间交互的页面的正常视图。The combination of WebPartZoneBase zones with WebPart (and other server) controls forms the primary UI of a Web Parts application, the normal view of a page that users interact with most of the time.

所有区域都为其所包含的控件提供一组通用的 UI 元素。All zones provide a common set of UI elements for the controls they contain. 有关所有区域通用的 UI 元素的详细讨论,请参阅 WebZone 类的类概述主题。For a detailed discussion of the UI elements common to all zones, see the class overview topic for the WebZone class. WebPartZoneBase 区域包括一个包含服务器控件的正文部分和一个关联的 WebPartChrome 对象,用于呈现包含的控件及其 chrome 元素,例如它们的谓词、边框等。The WebPartZoneBase zone includes a body section that contains server controls, and an associated WebPartChrome object used for rendering the contained controls and their chrome elements, such as their verbs, borders, and so on.

除了从 WebZone 类继承的功能外,WebPartZoneBase 类还添加了客户端控件拖动、特定谓词(以实现最小化、关闭、删除和编辑控件等常见 UI 操作)以及其他样式功能。In addition to the features inherited from the WebZone class, the WebPartZoneBase class adds client-side control dragging, specific verbs (to enable common UI actions such as minimizing, closing, deleting, and editing controls), and additional style features. 如果要设计数据库驱动的自定义区域,则 WebPartZoneBase 类也是继承自的类。The WebPartZoneBase class is also the class to inherit from if you want to design a custom zone that is database-driven. 例如,你可以创建一个继承自 WebPartZoneBase的自定义天气 Web 部件区域,并将其设计为包含和提供布局功能和其他服务,以进行数据绑定的 WebPart 控件并显示天气信息。For example, you could create a custom weather Web Parts zone that inherits from WebPartZoneBase, and is designed to contain and provide layout features and other services for WebPart controls that are data-bound and display weather information.

WebPartZoneBase 类包含很多用于在区域中使用样式属性的属性。The WebPartZoneBase class contains a number of properties for working with style attributes in a zone. 边框有多个属性,包括 BorderStyleBorderWidthThere are several properties for borders, including BorderStyle and BorderWidth. 有一组属性用于处理可在区域标头中显示的菜单的样式特性,例如 MenuLabelStyleMenuVerbStyle和其他属性。There is a group of properties for working with style attributes of menus that can appear in the header of a zone, such as MenuLabelStyle, MenuVerbStyle, and others.

WebPartZoneBase 类还包含若干用于处理区域中的谓词的成员。The WebPartZoneBase class also contains a number of members for handling verbs in a zone. 这些成员与区域中的部件控件上显示的谓词相关。These members relate to the verbs that appear on the part controls in the zone. 虽然可以将区域级别的谓词添加到 WebPartZoneBase 区域,但在默认情况下,它们没有任何。While zone-level verbs can be added to WebPartZoneBase zones, by default they do not have any. Web 部件控件集附带一组标准谓词,可用于部分控件,开发人员也可以添加自定义谓词。There is a set of standard verbs provided with the Web Parts control set for use with part controls, and developers can add custom verbs as well. 用于处理谓词的一些重要属性包括引用一些标准谓词对象的属性,例如 CloseVerbConnectVerbDeleteVerbEditVerbHelpVerbMinimizeVerbSome important properties for working with verbs include properties that reference some of the standard verb objects, such as CloseVerb, ConnectVerb, DeleteVerb, and EditVerb, HelpVerb, and MinimizeVerb. 标准谓词显示在区域中包含的每个控件的标题栏中的谓词菜单上(通常显示在 UI 中)。The standard verbs appear on a verbs menu (typically presented in the UI as a drop-down menu) in the title bar of each control contained in a zone. 还有一个 VerbButtonType 属性,可用于确定哪些类型的可单击对象表示 UI 中的谓词。There is also a VerbButtonType property that allows you to determine what type of clickable object represents a verb in the UI.

用于处理谓词的其他关键成员包括 OnCreateVerbs 方法,该方法是一个事件处理程序,可对其进行重写以用于谓词创建过程的自定义处理和 CreateVerbs 事件。Other key members for working with verbs include the OnCreateVerbs method, which is an event handler that can be overridden for custom handling of the verb creation process, and the CreateVerbs event.

WebPartZoneBase 类包含许多用于处理包含在区域中的 WebPart 控件的成员。The WebPartZoneBase class contains a number of members for working with WebPart controls contained within a zone. WebParts 属性引用区域中所有 WebPart (以及其他服务器)控件的集合。The WebParts property references the collection of all WebPart (and other server) controls in the zone. 若干方法对应于用户可以在区域中的 WebPart 控件上执行的标准谓词或操作,例如 CloseWebPartConnectWebPartEditWebPartSeveral methods correspond to the standard verbs or actions that a user can carry out on WebPart controls in a zone, such as CloseWebPart, ConnectWebPart, and EditWebPart.

WebPartZoneBase 类中还有许多成员,涉及 WebPart 控件在区域内的布局或排列方式。There are also a number of members in the WebPartZoneBase class that concern how the WebPart controls are laid out or arranged within the zone. AllowLayoutChange 属性确定控件是否可以在区域之间移动或在区域内重新排列。The AllowLayoutChange property determines whether controls can be moved among zones or rearranged within a zone by users. LayoutOrientation 属性允许您确定区域中的控件是水平排列还是垂直排列。The LayoutOrientation property allows you to determine whether the controls in a zone are arranged horizontally or vertically.

备注

Internet Explorer 可能会以意外的方式呈现 WebPartZone 或其包含的控件的高度,具体取决于区域的方向。Internet Explorer might render the height of a WebPartZone or its contained controls in an unexpected way, depending on the orientation of the zone. 有关更多详细信息,请参阅 LayoutOrientationHeight 属性的文档。For more details, see the documentation for the LayoutOrientation or the Height properties.

WebPartZoneBase 类中的其他方法提供了对区域的各个区域的呈现的编程控制。Other methods in the WebPartZoneBase class provide you with detailed programmatic control over the rendering of the various areas of a zone. 其中许多方法会重写从 WebZone 类继承的基方法,以自定义包含 WebPart 控件的区域的呈现。Many of these methods override the base methods inherited from the WebZone class, to customize the rendering for zones that contain WebPart controls. 重要的方法包括 RenderRenderBodyRenderDropCueRenderHeaderImportant methods include Render, RenderBody, RenderDropCue, and RenderHeader.

构造函数

WebPartZoneBase()

初始化该类供继承的类实例使用。Initializes the class for use by an inherited class instance. 此构造函数只能由继承的类调用。This constructor can only be called by an inherited class.

属性

AccessKey

获取或设置使您得以快速导航到 Web 服务器控件的访问键。Gets or sets the access key that allows you to quickly navigate to the Web server control.

(继承自 WebControl)
Adapter

获取控件的浏览器特定适配器。Gets the browser-specific adapter for the control.

(继承自 Control)
AllowLayoutChange

获取或设置指示区域中 WebPart 控件布局的值是否可以更改的值。Gets or sets a value that indicates whether the layout of WebPart controls can be changed within a zone.

AppRelativeTemplateSourceDirectory

获取或设置包含该控件的 PageUserControl 对象的应用程序相对虚拟目录。Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(继承自 Control)
Attributes

获取与控件的特性不对应的任意特性(只用于呈现)的集合。Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(继承自 WebControl)
BackColor

获取或设置 Web 服务器控件的背景色。Gets or sets the background color of the Web server control.

(继承自 WebControl)
BackImageUrl

获取或设置指向区域的背景图像的 URL。Gets or sets the URL to a background image for a zone.

(继承自 WebZone)
BindingContainer

获取包含该控件的数据绑定的控件。Gets the control that contains this control's data binding.

(继承自 Control)
BorderColor

获取或设置 WebPartZoneBase 控件的边框颜色。Gets or sets the color for the border of a WebPartZoneBase control.

BorderStyle

获取或设置环绕 WebPartZoneBase 控件的边框的种类。Gets or sets the kind of border that surrounds a WebPartZoneBase control.

BorderWidth

获取或设置环绕 WebPartZoneBase 控件的边框的宽度。Gets or sets the width of the border that surrounds a WebPartZoneBase control.

ChildControlsCreated

获取一个值,该值指示是否已创建服务器控件的子控件。Gets a value that indicates whether the server control's child controls have been created.

(继承自 Control)
ClientID

获取由 ASP.NET 生成的 HTML 标记的控件 ID。Gets the control ID for HTML markup that is generated by ASP.NET.

(继承自 Control)
ClientIDMode

获取或设置用于生成 ClientID 属性值的算法。Gets or sets the algorithm that is used to generate the value of the ClientID property.

(继承自 Control)
ClientIDSeparator

获取一个字符值,该值表示 ClientID 属性中使用的分隔符字符。Gets a character value representing the separator character used in the ClientID property.

(继承自 Control)
CloseVerb

获取对 WebPartVerb 对象的引用,该对象使最终用户能够关闭区域中的 WebPart 控件。Gets a reference to a WebPartVerb object that enables end users to close the WebPart controls in a zone.

ConnectVerb

获取对 WebPartVerb 对象的引用,该对象使最终用户能够创建 WebPart 控件之间的连接。Gets a reference to a WebPartVerb object that enables end users to create connections between WebPart controls.

Context

为当前 Web 请求获取与服务器控件关联的 HttpContext 对象。Gets the HttpContext object associated with the server control for the current Web request.

(继承自 Control)
Controls

获取表示 ControlCollection 中的子控件的 CompositeControl 对象。Gets a ControlCollection object that represents the child controls in a CompositeControl.

(继承自 CompositeControl)
ControlStyle

获取 Web 服务器控件的样式。Gets the style of the Web server control. 此属性主要由控件开发人员使用。This property is used primarily by control developers.

(继承自 WebControl)
ControlStyleCreated

获取一个值,该值指示是否已为 Style 属性创建了 ControlStyle 对象。Gets a value indicating whether a Style object has been created for the ControlStyle property. 此属性主要由控件开发人员使用。This property is primarily used by control developers.

(继承自 WebControl)
CssClass

获取或设置由 Web 服务器控件在客户端呈现的级联样式表 (CSS) 类。Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(继承自 WebControl)
DataItemContainer

如果命名容器实现 IDataItemContainer,则获取对命名容器的引用。Gets a reference to the naming container if the naming container implements IDataItemContainer.

(继承自 Control)
DataKeysContainer

如果命名容器实现 IDataKeysControl,则获取对命名容器的引用。Gets a reference to the naming container if the naming container implements IDataKeysControl.

(继承自 Control)
DeleteVerb

获取对 WebPartVerb 对象的引用,该对象使最终用户能够删除区域中的 WebPart 控件。Gets a reference to a WebPartVerb object that enables end users to delete the WebPart controls in a zone.

DesignMode

获取一个值,该值指示是否正在使用设计图面上的一个控件。Gets a value indicating whether a control is being used on a design surface.

(继承自 Control)
DisplayTitle

获取在某个 WebPartZoneBase 区域本身可见时被用作该区域标题的文本的当前值。Gets the current value of the text being used as the title for a WebPartZoneBase zone when the zone itself is visible.

DragDropEnabled

获取指示是否可以 WebPart 将控件拖入和拖出区域的值。Gets a value that indicates whether WebPart controls can be dragged into or out of a zone.

DragHighlightColor

获取或设置环绕 WebPartZoneBase 区域及用户拖动控件时放置提示范围的边框的颜色。Gets or sets the color around the border of a WebPartZoneBase zone and its drop-cue regions when a user is dragging a control.

EditVerb

获取对 WebPartVerb 对象的引用,该对象使最终用户能够编辑区域中的 WebPart 控件。Gets a reference to a WebPartVerb object that enables end users to edit WebPart controls in a zone.

EmptyZoneText

获取或设置在 WebPartZoneBase 控件不包含任何 WebPart 控件时出现的消息。Gets or sets a message that appears when a WebPartZoneBase control contains no WebPart controls.

EmptyZoneTextStyle

获取空区域中的占位符文本的样式特性。Gets the style attributes for the placeholder text in an empty zone.

(继承自 WebZone)
Enabled

获取或设置一个值,该值指示是否启用 Web 服务器控件。Gets or sets a value indicating whether the Web server control is enabled.

(继承自 WebControl)
EnableTheming

获取或设置一个值,该值指示主题是否应用于该控件。Gets or sets a value indicating whether themes apply to this control.

(继承自 WebControl)
EnableViewState

获取或设置一个值,该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(继承自 Control)
ErrorStyle

获取用于呈现在无法加载或创建 WebPart 控件时显示的错误消息的样式特性。Gets the style attributes for rendering the error message that is displayed if a WebPart control cannot be loaded or created.

(继承自 WebZone)
Events

获取控件的事件处理程序委托列表。Gets a list of event handler delegates for the control. 此属性为只读。This property is read-only.

(继承自 Control)
ExportVerb

获取对 WebPartVerb 对象的引用,该对象使最终用户能够导出区域中每个 WebPart 控件的 XML 定义文件。Gets a reference to a WebPartVerb object that enables end users to export an XML definition file for each WebPart control in a zone.

Font

获取与 Web 服务器控件关联的字体属性。Gets the font properties associated with the Web server control.

(继承自 WebControl)
FooterStyle

获取区域的页脚区域内容的样式特性。Gets the style attributes for the contents of a zone's footer area.

(继承自 WebZone)
ForeColor

获取或设置 Web 服务器控件的前景色(通常是文本颜色)。Gets or sets the foreground color (typically the color of the text) of the Web server control.

(继承自 WebControl)
HasAttributes

获取一个值,该值指示控件是否具有特性集。Gets a value indicating whether the control has attributes set.

(继承自 WebControl)
HasChildViewState

获取一个值,该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(继承自 Control)
HasFooter

获取一个值,该值指示区域中是否具有页脚区域。Gets a value indicating whether a zone has a footer area.

HasHeader

获取一个值,该值指示区域是否具有页眉区域。Gets a value indicating whether a zone has a header area.

HeaderStyle

获取区域的页眉区域内容的样式特性。Gets the style attributes for the contents of a zone's header area.

(继承自 WebZone)
HeaderText

获取或设置区域的页眉区的文本。Gets or sets the text for the header area of a zone.

(继承自 WebZone)
Height

获取或设置 Web 服务器控件的高度。Gets or sets the height of the Web server control.

(继承自 WebControl)
HelpVerb

获取对 WebPartVerb 对象的引用,该对象用于访问区域中 WebPart 控件的“帮助”内容。Gets a reference to a WebPartVerb object used to access Help content for WebPart controls in a zone.

ID

获取或设置分配给服务器控件的编程标识符。Gets or sets the programmatic identifier assigned to the server control.

(继承自 Control)
IdSeparator

获取用于分隔控件标识符的字符。Gets the character used to separate control identifiers.

(继承自 Control)
IsChildControlStateCleared

获取一个值,该值指示该控件中包含的控件是否具有控件状态。Gets a value indicating whether controls contained within this control have control state.

(继承自 Control)
IsEnabled

获取一个值,该值指示是否启用控件。Gets a value indicating whether the control is enabled.

(继承自 WebControl)
IsTrackingViewState

获取一个值,用于指示服务器控件是否会将更改保存到其视图状态中。Gets a value that indicates whether the server control is saving changes to its view state.

(继承自 Control)
IsViewStateEnabled

获取一个值,该值指示是否为该控件启用了视图状态。Gets a value indicating whether view state is enabled for this control.

(继承自 Control)
LayoutOrientation

获取或设置指示区域中的控件是垂直排列还是水平排列的值。Gets or sets a value that indicates whether controls in a zone are arranged vertically or horizontally.

LoadViewStateByID

获取一个值,该值指示控件是否通过 ID 而不是索引参与加载其视图状态。Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(继承自 Control)
MenuCheckImageStyle

获取应用于出现在选定谓词文本后的谓词菜单文本上的选中标记图像的特性。Gets style attributes that are applied to the check mark image that appears on a verbs menu next to the selected verb text.

MenuCheckImageUrl

获取或设置在区域中每个 WebPart 控件的谓词菜单中被用作选中标记的图像的 URL。Gets or sets the URL to an image used as a check mark in the verbs menu of each WebPart control in a zone.

MenuLabelHoverStyle

获取在用户将鼠标指针定位于 WebPart 控件标题栏中的谓词菜单标签上时被应用于该标签的样式特性。Gets style attributes that are applied to the label of a verbs menu in the title bar of a WebPart control when a user positions the mouse pointer over the label.

MenuLabelStyle

获取出现在区域中每个 WebPart 控件的标题栏中的谓词下拉菜单的标签的样式信息。Gets style information for the label of the verbs drop-down menu that appears in the title bar of each WebPart control in a zone.

MenuLabelText

获取或设置作为区域中每个 WebPart 控件的标题栏中的谓词下拉菜单的标签样式信息的值。Gets or sets the value that serves as a label for the verbs drop-down menu in the title bar of each WebPart control in a zone.

MenuPopupImageUrl

获取或设置图像的 URL,该图像打开区域中每个 WebPart 控件的标题栏中的谓词下拉菜单。Gets or sets the URL to an image that opens the verbs drop-down menu in the title bar of each WebPart control in a zone.

MenuPopupStyle

获取出现在区域中 WebPart 控件上的下拉谓词菜单的样式特性。Gets style attributes for the drop-down verbs menu that appears on WebPart controls in a zone.

MenuVerbHoverStyle

获取在最终用户将鼠标指针定位在谓词下拉菜单中的某个谓词之上时该谓词的外观的样式信息。Gets style information for the appearance of a verb in a verbs drop-down menu when an end user positions the mouse pointer over the verb.

MenuVerbStyle

获取谓词下拉菜单显示时该菜单中谓词的外观的样式信息。Gets style information for the appearance of a verb in a verbs drop-down menu when the menu is displayed.

MinimizeVerb

获取对 WebPartVerb 对象的引用,该对象使最终用户能够最小化区域中的 WebPart 控件。Gets a reference to a WebPartVerb object that enables end users to minimize WebPart controls in a zone.

NamingContainer

获取对服务器控件的命名容器的引用,此引用创建唯一的命名空间,以区分具有相同 ID 属性值的服务器控件。Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(继承自 Control)
Padding

获取或设置区域中包含 WebPart 控件的表的单元格填充特性。Gets or sets the cell padding attributes on the table that contains the WebPart controls in a zone.

(继承自 WebZone)
Page

获取对包含服务器控件的 Page 实例的引用。Gets a reference to the Page instance that contains the server control.

(继承自 Control)
Parent

获取对页 UI 层次结构中服务器控件的父控件的引用。Gets a reference to the server control's parent control in the page control hierarchy.

(继承自 Control)
PartChromePadding

获取或设置 WebPart 控件的内容和此控件的边框之间的距离。Gets or sets the distance between the contents of a WebPart control and the border of the control.

(继承自 WebZone)
PartChromeStyle

获取适用于区域所包含的 Web 部件控件的边框的样式属性。Gets style characteristics that apply to the borders of Web Parts controls contained by a zone.

(继承自 WebZone)
PartChromeType

获取或设置构成区域所包含的 Web 部件控件的框架的边框类型。Gets or sets the type of border that frames Web Parts controls contained by a zone.

(继承自 WebZone)
PartStyle

获取适用于区域所包含的每个 Web 部件控件的边框和内容的样式属性。Gets style characteristics that apply to the border and contents of each Web Parts control contained by a zone.

(继承自 WebZone)
PartTitleStyle

获取区域所包含的每个 Web 部件控件的标题栏内容的样式特性。Gets style attributes for the title bar content for each Web Parts control contained by a zone.

(继承自 WebZone)
RenderClientScript

获取一个值,该值指示是否在 Web 部件页上呈现客户端脚本。Gets a value that indicates whether to render client script on a Web Parts page.

(继承自 WebZone)
RenderingCompatibility

获取一个值,该值指定呈现的 HTML 将与之兼容的 ASP.NET 版本。Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(继承自 Control)
RestoreVerb

获取对 WebPartVerb 对象的引用,该对象使最终用户能够将区域中的 WebPart 控件还原为正常大小。Gets a reference to a WebPartVerb object that enables end users to restore WebPart controls in a zone to normal size.

SelectedPartChromeStyle

获取区域中选定的 WebPart 控件的外观的样式信息。Gets style information for the appearance of a selected WebPart control in a zone.

ShowTitleIcons

获取或设置指示标题图标是否显示在区域中每个 WebPart 控件的标题栏中的值。Gets or sets a value that indicates whether title icons are displayed in the title bar of each WebPart control in a zone.

Site

获取容器信息,该容器在呈现于设计图面上时承载当前控件。Gets information about the container that hosts the current control when rendered on a design surface.

(继承自 Control)
SkinID

获取或设置要应用于控件的外观。Gets or sets the skin to apply to the control.

(继承自 WebControl)
Style

获取将在 Web 服务器控件的外部标记上呈现为样式特性的文本特性的集合。Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(继承自 WebControl)
SupportsDisabledAttribute

获取一个值,该值指示在控件的 IsEnabled 属性为 disabled 时,控件是否应将呈现的 HTML 元素的 false 特性设置为“disabled”。Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(继承自 CompositeControl)
TabIndex

获取或设置 Web 服务器控件的选项卡索引。Gets or sets the tab index of the Web server control.

(继承自 WebControl)
TagKey

获取对应于此 Web 服务器控件的 HtmlTextWriterTag 值。Gets the HtmlTextWriterTag value that corresponds to this Web server control. 此属性主要由控件开发人员使用。This property is used primarily by control developers.

(继承自 WebZone)
TagName

获取控件标记的名称。Gets the name of the control tag. 此属性主要由控件开发人员使用。This property is used primarily by control developers.

(继承自 WebControl)
TemplateControl

获取或设置对包含该控件的模板的引用。Gets or sets a reference to the template that contains this control.

(继承自 Control)
TemplateSourceDirectory

获取包含当前服务器控件的 PageUserControl 的虚拟目录。Gets the virtual directory of the Page or UserControl that contains the current server control.

(继承自 Control)
TitleBarVerbButtonType

获取或设置用于 WebPart 控件的标题栏中的谓词的按钮类型。Gets or sets the type of button used for the verbs in the title bar of WebPart controls.

TitleBarVerbStyle

获取 WebPart 控件的标题栏中的谓词的样式特性。Gets style attributes for verbs in the title bar of a WebPart control.

ToolTip

获取或设置当鼠标指针悬停在 Web 服务器控件上时显示的文本。Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(继承自 WebControl)
UniqueID

获取服务器控件的唯一的、以分层形式限定的标识符。Gets the unique, hierarchically qualified identifier for the server control.

(继承自 Control)
ValidateRequestMode

获取或设置指示控件是否检查来自浏览器的客户端输入是否具有潜在危险值的值。Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(继承自 Control)
VerbButtonType

获取或设置与 WebPartZoneBase 区域中存在的谓词关联的按钮类型(当使用较早的浏览器访问时)。Gets or sets the kind of button associated with the verbs that exist in a WebPartZoneBase zone when accessed with an older browser.

VerbStyle

获取与区域中的 Web 部件控件关联的用户界面 (UI) 谓词的样式特性。Gets the style attributes for the user interface (UI) verbs associated with Web Parts controls in a zone.

(继承自 WebZone)
ViewState

获取状态信息的字典,这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(继承自 Control)
ViewStateIgnoresCase

获取一个值,该值指示 StateBag 对象是否不区分大小写。Gets a value that indicates whether the StateBag object is case-insensitive.

(继承自 Control)
ViewStateMode

获取或设置此控件的视图状态模式。Gets or sets the view-state mode of this control.

(继承自 Control)
Visible

获取或设置一个值,该值指示服务器控件是否作为 UI 呈现在页上。Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(继承自 Control)
WebPartChrome

获取对 WebPartChrome 对象的引用,该对象确定区域中 WebPart 控件的外围呈现。Gets a reference to the WebPartChrome object that determines the peripheral rendering for WebPart controls in the zone.

WebPartManager

获取对与 Web 部件页上的 WebPartManager 控件实例关联的 WebZone 控件的引用。Gets a reference to the WebPartManager control associated with a WebZone control instance on a Web Parts page.

(继承自 WebZone)
WebParts

获取区域中包含的 Web 部件控件的集合。Gets the collection of Web Parts controls contained within a zone.

WebPartVerbRenderMode

获取或设置指示应该如何在区域中的 WebPart 控件上呈现谓词的值。Gets or sets a value indicating how the verbs should be rendered on WebPart controls in the zone.

Width

获取或设置 Web 服务器控件的宽度。Gets or sets the width of the Web server control.

(继承自 WebControl)

方法

AddAttributesToRender(HtmlTextWriter)

将需要呈现的 HTML 特性和样式添加到指定的 HtmlTextWriterTag 中。Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. 此方法主要由控件开发人员使用。This method is used primarily by control developers.

(继承自 WebControl)
AddedControl(Control, Int32)

在子控件添加到 Controls 对象的 Control 集合后调用。Called after a child control is added to the Controls collection of the Control object.

(继承自 Control)
AddParsedSubObject(Object)

通知服务器控件,分析了一个元素(XML 或 HTML),并将该元素添加到服务器控件的 ControlCollection 对象中。Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(继承自 Control)
ApplyStyle(Style)

将指定样式的所有非空白元素复制到 Web 控件,覆盖控件的所有现有的样式元素。Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. 此方法主要由控件开发人员使用。This method is primarily used by control developers.

(继承自 WebControl)
ApplyStyleSheetSkin(Page)

将页样式表中定义的样式属性应用到控件。Applies the style properties defined in the page style sheet to the control.

(继承自 Control)
BeginRenderTracing(TextWriter, Object)

开始输出数据的设计时追踪。Begins design-time tracing of rendering data.

(继承自 Control)
BuildProfileTree(String, Boolean)

收集有关服务器控件的信息并将该信息发送到 Trace 属性,在启用页的跟踪功能时将显示该属性。Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(继承自 Control)
ClearCachedClientID()

将缓存的 ClientID 值设置为 nullSets the cached ClientID value to null.

(继承自 Control)
ClearChildControlState()

删除服务器控件的子控件的控件状态信息。Deletes the control-state information for the server control's child controls.

(继承自 Control)
ClearChildState()

删除服务器控件的所有子控件的视图状态和控件状态信息。Deletes the view-state and control-state information for all the server control's child controls.

(继承自 Control)
ClearChildViewState()

删除服务器控件的所有子控件的视图状态信息。Deletes the view-state information for all the server control's child controls.

(继承自 Control)
ClearEffectiveClientIDMode()

将当前控件实例和任何子控件的 ClientIDMode 属性设置为 InheritSets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(继承自 Control)
CloseWebPart(WebPart)

关闭区域中选定的 WebPart 控件。Closes a selected WebPart control in a zone.

ConnectWebPart(WebPart)

开始创建两个 WebPart 控件之间的连接的过程。Initiates the process of creating a connection between two WebPart controls.

CopyBaseAttributes(WebControl)

Style 对象未封装的属性从指定的 Web 服务器控件复制到从中调用此方法的 Web 服务器控件。Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. 此方法主要由控件开发人员使用。This method is used primarily by control developers.

(继承自 WebControl)
CreateChildControls()

创建区域中包含的子控件集。Creates the set of child controls contained in a zone.

CreateControlCollection()

创建包含区域中的所有控件的 ControlCollection 对象。Creates a ControlCollection object that contains all the controls in a zone.

CreateControlStyle()

创建在区域控件可见时应用于它的样式特征的集合。Creates a set of style characteristics that apply to a zone control when it is visible.

CreateWebPartChrome()

使派生区域能够替换自定义的 WebPartChrome 对象以更改区域中 WebPart 控件的外观。Enables derived zones to substitute a custom WebPartChrome object to change the appearance of WebPart controls in a zone.

DataBind()

将数据源绑定到 CompositeControl 及其所有子控件。Binds a data source to the CompositeControl and all its child controls.

(继承自 CompositeControl)
DataBind(Boolean)

将数据源绑定到调用的服务器控件及其所有子控件,同时可以选择引发 DataBinding 事件。Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(继承自 Control)
DataBindChildren()

将数据源绑定到服务器控件的子控件。Binds a data source to the server control's child controls.

(继承自 Control)
DeleteWebPart(WebPart)

删除区域中选定的 WebPart 控件。Deletes a selected WebPart control in a zone.

Dispose()

使服务器控件得以在从内存中释放之前执行最后的清理操作。Enables a server control to perform final clean up before it is released from memory.

(继承自 Control)
EditWebPart(WebPart)

开始编辑区域中选定的 WebPart 控件的过程。Initiates the process of editing a selected WebPart control in a zone.

EndRenderTracing(TextWriter, Object)

结束输出数据的设计时追踪。Ends design-time tracing of rendering data.

(继承自 Control)
EnsureChildControls()

确定服务器控件是否包含子控件。Determines whether the server control contains child controls. 如果不包含,则创建子控件。If it does not, it creates child controls.

(继承自 Control)
EnsureID()

为尚未分配标识符的控件创建标识符。Creates an identifier for controls that do not have an identifier assigned.

(继承自 Control)
Equals(Object)

确定指定对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(继承自 Object)
FindControl(String)

在当前的命名容器中搜索带指定 id 参数的服务器控件。Searches the current naming container for a server control with the specified id parameter.

(继承自 Control)
FindControl(String, Int32)

使用指定的 idpathOffset 参数(该参数有助于搜索)中指定的整数在当前命名容器中搜索服务器控件。Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. 不应重写此版本的 FindControl 方法。You should not override this version of the FindControl method.

(继承自 Control)
Focus()

为控件设置输入焦点。Sets input focus to a control.

(继承自 Control)
GetDesignModeState()

获取控件的设计时数据。Gets design-time data for a control.

(继承自 Control)
GetEffectiveChromeType(Part)

给定该区域的 PartChromeType 属性以及 Web 部件页的当前显示模式,则返回 WebPart 控件实际或有效的当前 PartChromeType 值。Returns the actual or effective current PartChromeType value of a WebPart control, given the PartChromeType property of the zone and the current display mode of the Web Parts page.

GetHashCode()

用作默认哈希函数。Serves as the default hash function.

(继承自 Object)
GetInitialWebParts()

根据模板或某种存储介质获取区域中包含的 WebPart 控件的初始集合。Gets an initial collection of WebPart controls contained in a zone, based on a template or some storage medium.

GetRouteUrl(Object)

获取与一组路由参数对应的 URL。Gets the URL that corresponds to a set of route parameters.

(继承自 Control)
GetRouteUrl(RouteValueDictionary)

获取与一组路由参数对应的 URL。Gets the URL that corresponds to a set of route parameters.

(继承自 Control)
GetRouteUrl(String, Object)

获取与一组路由参数以及某个路由名称对应的 URL。Gets the URL that corresponds to a set of route parameters and a route name.

(继承自 Control)
GetRouteUrl(String, RouteValueDictionary)

获取与一组路由参数以及某个路由名称对应的 URL。Gets the URL that corresponds to a set of route parameters and a route name.

(继承自 Control)
GetType()

获取当前实例的 TypeGets the Type of the current instance.

(继承自 Object)
GetUniqueIDRelativeTo(Control)

返回指定控件的 UniqueID 属性的前缀部分。Returns the prefixed portion of the UniqueID property of the specified control.

(继承自 Control)
HasControls()

确定服务器控件是否包含任何子控件。Determines if the server control contains any child controls.

(继承自 Control)
HasEvents()

返回一个值,该值指示是否为控件或任何子控件注册事件。Returns a value indicating whether events are registered for the control or any child controls.

(继承自 Control)
IsLiteralContent()

确定服务器控件是否只包含文字内容。Determines if the server control holds only literal content.

(继承自 Control)
LoadControlState(Object)

SaveControlState() 方法保存的上一个页请求还原控件状态信息。Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(继承自 Control)
LoadViewState(Object)

为某个区域加载以前保存的状态信息。Loads previously saved state information for a zone.

MapPathSecure(String)

检索虚拟路径(绝对的或相对的)映射到的物理路径。Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(继承自 Control)
MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)
MergeStyle(Style)

将指定样式的所有非空白元素复制到 Web 控件,但不覆盖该控件现有的任何样式元素。Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. 此方法主要由控件开发人员使用。This method is used primarily by control developers.

(继承自 WebControl)
MinimizeWebPart(WebPart)

最小化区域中选定的 WebPart 控件。Minimizes a selected WebPart control in a zone.

OnBubbleEvent(Object, EventArgs)

确定服务器控件的事件是否沿页的 UI 服务器控件层次结构向上传递。Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(继承自 Control)
OnCreateVerbs(WebPartVerbsEventArgs)

引发 CreateVerbs 事件。Raises the CreateVerbs event.

OnDataBinding(EventArgs)

引发 DataBinding 事件。Raises the DataBinding event.

(继承自 Control)
OnInit(EventArgs)

引发 Init 事件。Raises the Init event.

(继承自 WebZone)
OnLoad(EventArgs)

引发 Load 事件。Raises the Load event.

(继承自 Control)
OnPreRender(EventArgs)

引发 PreRender 事件。Raises the PreRender event.

OnUnload(EventArgs)

引发 Unload 事件。Raises the Unload event.

(继承自 Control)
OpenFile(String)

获取用于读取文件的 StreamGets a Stream used to read a file.

(继承自 Control)
RaiseBubbleEvent(Object, EventArgs)

将所有事件源及其信息分配给控件的父级。Assigns any sources of the event and its information to the control's parent.

(继承自 Control)
RaisePostBackEvent(String)

根据自最近的回发事件以来所发生的更改更新区域中 WebPart 控件的当前集合的状态。Updates the status of the current collection of WebPart controls in a zone, based on the changes that have occurred since the most recent postback event.

RecreateChildControls()

在派生自 CompositeControl 的控件中重新创建子控件。Recreates the child controls in a control derived from CompositeControl.

(继承自 CompositeControl)
RemovedControl(Control)

Controls 对象的 Control 集合移除子控件后调用。Called after a child control is removed from the Controls collection of the Control object.

(继承自 Control)
Render(HtmlTextWriter)

将区域呈现给指定的 HtmlTextWriter 对象。Renders the zone to the specified HtmlTextWriter object.

RenderBeginTag(HtmlTextWriter)

将区域控件的 HTML 开始标记呈现为指定的 HtmlTextWriter 对象。Renders the opening HTML tag of the zone control to the specified HtmlTextWriter object.

(继承自 WebZone)
RenderBody(HtmlTextWriter)

重写基方法,以便呈现某个区域的正文区,该区域从 WebPartZoneBase 类派生。Overrides the base method to render the body area of a zone derived from the WebPartZoneBase class.

RenderChildren(HtmlTextWriter)

将服务器控件子级的内容输出到提供的 HtmlTextWriter 对象,该对象可写入要在客户端上呈现的内容。Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(继承自 Control)
RenderContents(HtmlTextWriter)

将区域控件中开始标记和结束标记之间的所有内容呈现为指定的 HtmlTextWriter 对象。Renders the entire contents of a zone control between the beginning and ending tags to the specified HtmlTextWriter object.

(继承自 WebZone)
RenderControl(HtmlTextWriter)

将服务器控件内容输出到所提供的 HtmlTextWriter 对象,如果启用了跟踪,则还将存储有关该控件的跟踪信息。Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(继承自 Control)
RenderControl(HtmlTextWriter, ControlAdapter)

使用提供的 HtmlTextWriter 对象将服务器控件内容输出到提供的 ControlAdapter 对象。Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(继承自 Control)
RenderDropCue(HtmlTextWriter)

呈现用户界面 (UI) 元素以便向最终用户指示当前正被拖动的 WebPart 控件在区域中的可放置位置。Renders user interface (UI) elements to indicate to an end user where a WebPart control that is being dragged can be dropped within a zone.

RenderEndTag(HtmlTextWriter)

将控件的 HTML 结束标记呈现到指定的编写器中。Renders the HTML closing tag of the control into the specified writer. 此方法主要由控件开发人员使用。This method is used primarily by control developers.

(继承自 WebControl)
RenderFooter(HtmlTextWriter)

重写对区域控件的页脚的呈现。Overrides rendering for the footer of a zone control.

(继承自 WebZone)
RenderHeader(HtmlTextWriter)

重写基方法以呈现包含 WebPartZoneBase 控件的 WebPart 区域的页眉。Overrides the base method to render the header of a WebPartZoneBase zone that contains WebPart controls.

ResolveAdapter()

获取负责呈现指定控件的控件适配器。Gets the control adapter responsible for rendering the specified control.

(继承自 Control)
ResolveClientUrl(String)

获取浏览器可以使用的 URL。Gets a URL that can be used by the browser.

(继承自 Control)
ResolveUrl(String)

将 URL 转换为在请求客户端可用的 URL。Converts a URL into one that is usable on the requesting client.

(继承自 Control)
RestoreWebPart(WebPart)

将被最小化的选定 WebPart 控件还原到正常状态。Restores a selected WebPart control that was minimized to normal state.

SaveControlState()

保存将页面回发到服务器之后发生的所有服务器控件状态更改。Saves any server control state changes that have occurred since the time the page was posted back to the server.

(继承自 Control)
SaveViewState()

将页面发布回服务器之后,保存已发生的所有视图状态的更改。Saves any view-state changes that have occurred after a page was posted back to the server.

SetDesignModeState(IDictionary)

为控件设置设计时数据。Sets design-time data for a control.

(继承自 Control)
SetRenderMethodDelegate(RenderMethod)

分配事件处理程序委托,以将服务器控件及其内容呈现到父控件中。Assigns an event handler delegate to render the server control and its content into its parent control.

(继承自 Control)
SetTraceData(Object, Object)

使用跟踪数据键和跟踪数据值,为呈现数据的设计时追踪设置跟踪数据。Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(继承自 Control)
SetTraceData(Object, Object, Object)

使用跟踪对象、跟踪数据键和跟踪数据值,为呈现数据的设计时追踪设置跟踪数据。Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(继承自 Control)
ToString()

返回表示当前对象的字符串。Returns a string that represents the current object.

(继承自 Object)
TrackViewState()

开始对区域的视图状态更改的跟踪过程,以便将它们存储在一个 StateBag 对象中,并通过 ViewState 属性进行访问。Begins the process of tracking view-state changes to a zone so that they can be stored in a StateBag object, and accessed through the ViewState property.

事件

CreateVerbs

在为从 WebPartZoneBase 类派生的区域创建谓词时发生。Occurs when the verbs are created for a zone that derives from the WebPartZoneBase class.

DataBinding

当服务器控件绑定到数据源时发生。Occurs when the server control binds to a data source.

(继承自 Control)
Disposed

当从内存释放服务器控件时发生,这是请求 ASP.NET 页时服务器控件生存期的最后阶段。Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(继承自 Control)
Init

当服务器控件初始化时发生;初始化是控件生存期的第一步。Occurs when the server control is initialized, which is the first step in its lifecycle.

(继承自 Control)
Load

当服务器控件加载到 Page 对象中时发生。Occurs when the server control is loaded into the Page object.

(继承自 Control)
PreRender

在加载 Control 对象之后、呈现之前发生。Occurs after the Control object is loaded but prior to rendering.

(继承自 Control)
Unload

当服务器控件从内存中卸载时发生。Occurs when the server control is unloaded from memory.

(继承自 Control)

显式接口实现

IAttributeAccessor.GetAttribute(String)

获取具有指定名称的 Web 控件的特性。Gets an attribute of the Web control with the specified name.

(继承自 WebControl)
IAttributeAccessor.SetAttribute(String, String)

将 Web 控件的特性设置为指定的名称和值。Sets an attribute of the Web control to the specified name and value.

(继承自 WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

启用设计器,以便在设计时环境中重新创建子控件的复合控件集合。Enables a designer to recreate the composite control's collection of child controls in the design-time environment.

(继承自 CompositeControl)
IControlBuilderAccessor.ControlBuilder

有关此成员的说明,请参阅 ControlBuilderFor a description of this member, see ControlBuilder.

(继承自 Control)
IControlDesignerAccessor.GetDesignModeState()

有关此成员的说明,请参阅 GetDesignModeState()For a description of this member, see GetDesignModeState().

(继承自 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

有关此成员的说明,请参阅 SetDesignModeState(IDictionary)For a description of this member, see SetDesignModeState(IDictionary).

(继承自 Control)
IControlDesignerAccessor.SetOwnerControl(Control)

有关此成员的说明,请参阅 SetOwnerControl(Control)For a description of this member, see SetOwnerControl(Control).

(继承自 Control)
IControlDesignerAccessor.UserData

有关此成员的说明,请参阅 UserDataFor a description of this member, see UserData.

(继承自 Control)
IDataBindingsAccessor.DataBindings

有关此成员的说明,请参阅 DataBindingsFor a description of this member, see DataBindings.

(继承自 Control)
IDataBindingsAccessor.HasDataBindings

有关此成员的说明,请参阅 HasDataBindingsFor a description of this member, see HasDataBindings.

(继承自 Control)
IExpressionsAccessor.Expressions

有关此成员的说明,请参阅 ExpressionsFor a description of this member, see Expressions.

(继承自 Control)
IExpressionsAccessor.HasExpressions

有关此成员的说明,请参阅 HasExpressionsFor a description of this member, see HasExpressions.

(继承自 Control)
IParserAccessor.AddParsedSubObject(Object)

有关此成员的说明,请参阅 AddParsedSubObject(Object)For a description of this member, see AddParsedSubObject(Object).

(继承自 Control)
IPostBackEventHandler.RaisePostBackEvent(String)

有关此成员的说明,请参阅 RaisePostBackEvent(String)For a description of this member, see RaisePostBackEvent(String).

扩展方法

FindDataSourceControl(Control)

返回与指定控件的数据控件关联的数据源。Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

返回指定控件的命名容器中指定列的字段模板。Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

返回包含数据控件的元表对象。Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

为指定数据控件获取默认值的集合。Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

为指定数据控件获取表元数据。Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

为指定数据控件设置表元数据。Sets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

为指定数据控件设置表元数据和默认值映射。Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

为指定数据控件设置表元数据和默认值映射。Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

确定表元数据是否可用。Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

为指定数据控件启用动态数据行为。Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

为指定数据控件启用动态数据行为。Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

为指定数据控件启用动态数据行为。Enables Dynamic Data behavior for the specified data control.

适用于

另请参阅