WebPartZoneCollection 构造函数

定义

命名空间:

System.Web.UI.WebControls.WebParts

程序集:

System.Web.dll

初始化 WebPartZoneCollection 类的新实例。

重载

WebPartZoneCollection()	初始化 WebPartZoneCollection 类的空实例。
WebPartZoneCollection(ICollection)	通过传入 WebPartZoneCollection 对象的集合来初始化 WebPartZone 类的实例。

注解

控件 WebPartZoneCollection 、Web 部件控件集中的其他控件或自定义开发人员代码使用该 WebPartManager 构造函数来创建存在于 Web 部件页上的 WebPartZone 控件的只读集合。

WebPartZoneCollection()

初始化 WebPartZoneCollection 类的空实例。

public:
 WebPartZoneCollection();

public WebPartZoneCollection ();

Public Sub New ()

注解

控件 WebPartManager 在其自己的构造函数中使用此构造函数为 Web 部件页初始化 类的新实例 WebPartZoneCollection 。

另请参阅

• ASP.NET Web 部件控件

WebPartZoneCollection(ICollection)

通过传入 WebPartZoneCollection 对象的集合来初始化 WebPartZone 类的实例。

public:
 WebPartZoneCollection(System::Collections::ICollection ^ webPartZones);

public WebPartZoneCollection (System.Collections.ICollection webPartZones);

new System.Web.UI.WebControls.WebParts.WebPartZoneCollection : System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.WebPartZoneCollection

Public Sub New (webPartZones As ICollection)

参数

webPartZones

ICollection

ICollection 对象的 WebPartZone。

例外

ArgumentNullException

区域的集合为 null。

ArgumentException

集合中的某个对象是 null，或其类型不是 WebPartZone。

示例

下面的代码示例演示如何使用 WebPartZoneCollection 构造函数。 示例的完整代码位于类概述的 WebPartZoneCollection “示例”部分。

在代码的以下部分中，请注意，它通过检索 属性的值Zones将对象分配给WebPartZoneCollection变量。 如果需要，可以创建包含页面上所有区域子集的对象WebPartZoneBase数组，并将数组分配给新WebPartZoneCollection对象，而不是从 Zones 属性分配所有区域。

protected void Button5_Click(object sender, EventArgs e)
{
  Label1.Text = String.Empty;

  WebPartZoneCollection zoneCollection = mgr.Zones;
  foreach (WebPartZone zone in zoneCollection)
  {

    if (zone.WebPartVerbRenderMode == WebPartVerbRenderMode.Menu)
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar;
    else
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu;
  }
}

Protected Sub Button5_Click(ByVal sender As Object, ByVal e As EventArgs)
  Label1.Text = String.Empty

  Dim zoneCollection As WebPartZoneCollection = mgr.Zones
  Dim zone As WebPartZone
  For Each zone In zoneCollection
    If zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu Then
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar
    Else
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu
    End If
  Next zone

End Sub

创建集合后，可以轻松循环访问集合，并对所有包含的区域或其内容执行操作。 若要执行示例代码，请在浏览器中加载页面，然后单击每个区域中的“ 切换谓词呈现模式 ”按钮。 这交替了区域中包含的每个服务器控件的标题栏中谓词的呈现方式。 谓词可以显示在下拉菜单中，也可以直接作为链接显示在标题栏中。

注解

WebPartZoneCollection如果要创建自定义对象集合WebPartZone以对其执行编程操作，请使用 构造函数。 例如，可以访问 Zones 属性并在 Web 部件页上创建对象的子集 WebPartZone ，将它们分配给对象 WebPartZoneCollection ，然后对仅该区域子集的子控件或各种属性执行操作。

另请参阅

• ASP.NET Web 部件控件