EditorZoneBase.EditorParts 属性

定义

命名空间:

System.Web.UI.WebControls.WebParts

程序集:

System.Web.dll

获取 EditorPart 区域中包含的所有 EditorZoneBase 控件的集合。

public:
 property System::Web::UI::WebControls::WebParts::EditorPartCollection ^ EditorParts { System::Web::UI::WebControls::WebParts::EditorPartCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.EditorPartCollection EditorParts { get; }

[<System.ComponentModel.Browsable(false)>]
member this.EditorParts : System.Web.UI.WebControls.WebParts.EditorPartCollection

Public ReadOnly Property EditorParts As EditorPartCollection

属性值

EditorPartCollection

包含某个区域中所有单个 EditorPartCollection 控件的 EditorPart。

属性

BrowsableAttribute

例外

InvalidOperationException

要添加到集合的 EditorPart 的 ID 属性尚未赋值。

示例

下面的代码示例演示如何以编程方式访问 EditorParts 属性。 有关运行示例所需的完整代码，请参阅类概述主题的 EditorZoneBase “示例”部分。

代码示例的第一部分演示 属性 EditorParts 包含对网页中以声明方式引用的所有 EditorPart 控件的引用。

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

代码示例的第二部分以编程方式访问 EditorParts 属性，并列出控件中 Label 每个控件的 ID。

void Button3_Click(object sender, EventArgs e)
{
  Label1.Text = "<br />";
  foreach (EditorPart part in EditorZone1.EditorParts)
  {
    Label1.Text += part.ID + "<br />";
  }
}

Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
  Label1.Text = "<br />"
  Dim part As EditorPart
  For Each part In EditorZone1.EditorParts
    Label1.Text += part.ID + "<br />"
  Next part
End Sub

在浏览器中加载页面时，可以单击“ 显示编辑器”“部件集合 ”按钮，列出 属性中引用的所有 EditorPart 控件的 EditorParts ID。

注解

属性 EditorParts 提供对区域中所有控件的集合的 EditorPart 引用。 它同时 EditorPart 引用随 Web 部件控件集提供的控件，以及添加到区域的任何自定义 EditorPart 控件。 由于集合是只读的，因此想要 EditorPart 创建自定义控件以进行常规编辑并将其添加到集合的开发人员应重写 CreateEditorParts 方法。

如果设计自定义EditorPart控件以编辑特定WebPart控件，则应重写控件中的 WebPart 接口成员IWebEditable（CreateEditorParts方法）和 WebBrowsableObject 属性。 重写这些成员的原因是使控件能够在 WebPart 编辑控件时创建自定义 EditorPart 控件并将其添加到 EditorParts 集合中，并为编辑控件提供对其正在编辑的 WebPart 控件的对象引用。 如果要添加自定义 EditorPart 控件以编辑不从 WebPart 类继承的服务器控件，则必须在 类中实现 接口， IWebEditable 就像对控件一 WebPart 样。

注意

请注意，在 方法的实现CreateEditorParts中添加到控件集合EditorPart中的任何EditorPart值都必须具有分配给其 ID 属性的值，否则在将集合分配给 属性EditorParts时将引发异常。

另请参阅

• IWebEditable
• CreateEditorParts()
• CreateEditorParts()
• ASP.NET Web 部件控件