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

在浏览器中加载页面时，可以单击“显示编辑器”“部件集合”按钮，列出 属性中EditorParts引用的所有EditorPart控件的 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 部件控件