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 。

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 識別碼。

備註

屬性 EditorParts 提供區域中所有 EditorPart 控制項集合的參考。 它會參考 Web 元件控制項集所提供的控制項 EditorPart ，以及新增至區域的任何自訂 EditorPart 控制項。 由於集合是唯讀的，因此想要建立自訂 EditorPart 控制項以供一般編輯用途的開發人員，並將其新增至集合應該會覆寫 CreateEditorParts 方法。

如果您設計自訂 EditorPart 控制項來編輯特定 WebPart 控制項，您應該覆寫 interface 的成員 IWebEditable ，也就是 CreateEditorParts 方法與 WebBrowsableObject 屬性 WebPart 中的 控制項。 覆寫這些成員的原因是讓 WebPart 控制項建立自訂 EditorPart 控制項，並在編輯控制項時將它們新增至 EditorParts 集合，並提供編輯控制項的物件參考給它們正在編輯的 WebPart 控制項。 如果您想要新增自訂 EditorPart 控制項來編輯未繼承自 WebPart 類別的伺服器控制項，您必須在 類別中實 IWebEditable 作 介面，就像是 WebPart 控制項一樣。

注意

請注意，在 EditorPart 方法實 CreateEditorParts 作中新增至控制項集合 EditorPart 的任何都必須有指派給其 ID 屬性的值，否則在將集合指派給 EditorParts 屬性時，將會擲回例外狀況。

另請參閱

• IWebEditable
• CreateEditorParts()
• CreateEditorParts()
• ASP.NET 網頁元件控制項