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 控件一樣。

注意

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

另請參閱

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