IWebEditable.CreateEditorParts 方法

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

傳回與伺服器控制項相關聯之自訂 EditorPart 控制項的集合，該伺服器控制項會實作 IWebEditable 介面。

public:
 System::Web::UI::WebControls::WebParts::EditorPartCollection ^ CreateEditorParts();

public System.Web.UI.WebControls.WebParts.EditorPartCollection CreateEditorParts ();

abstract member CreateEditorParts : unit -> System.Web.UI.WebControls.WebParts.EditorPartCollection

Public Function CreateEditorParts () As EditorPartCollection

傳回

EditorPartCollection

EditorPartCollection，包含與伺服器控制項相關聯之自訂 EditorPart 控制項的集合。

範例

下列程式代碼範例示範自定義WebPart控件中 方法的CreateEditorParts覆寫。 在類別概觀主題的 IWebEditable 範例一節中找到執行範例所需的完整原始程式碼。

程式代碼範例包含介面的 IWebEditable 兩個成員。 請注意，方法的 CreateEditorParts 覆寫會 ArrayList 建立 來收集一或多個自定義 EditorPart 控件，然後使用清單來建立 EditorPartCollection 物件。

public override EditorPartCollection CreateEditorParts()
{
  ArrayList editorArray = new ArrayList();
  TextDisplayEditorPart edPart = new TextDisplayEditorPart();
  edPart.ID = this.ID + "_editorPart1";
  editorArray.Add(edPart);
  EditorPartCollection editorParts = 
    new EditorPartCollection(editorArray);
  return editorParts;
}

public override object WebBrowsableObject
{
  get { return this; }
}

Public Overrides Function CreateEditorParts() _
                            As EditorPartCollection
  Dim editorArray As New ArrayList()
  Dim edPart as New TextDisplayEditorPart()
  edPart.ID = Me.ID & "_editorPart1"
  editorArray.Add(edPart)
  Dim editorParts As New EditorPartCollection(editorArray)
  Return editorParts

End Function

Public Overrides ReadOnly Property WebBrowsableObject() _
                                    As Object
  Get
    Return Me
  End Get
End Property

備註

方法CreateEditorParts可讓您建立與自定義控件、WebPart控件或使用者控件相關聯的所有自定義EditorPart控件集合，並將它們當做 EditorPartCollection 對象傳回。 只要伺服器控制項進入編輯模式，控制項 WebPartManager 就會取得集合並建立所有 EditorPart 控制件的實例。

一般而言，您會藉由覆寫其 CreateEditorParts 方法，在自定義WebPart控件中實作這個方法。 在方法中，您會建立想要與控件產生關聯的自定義 EditorPart 控件實例、將它們新增至 EditorPartCollection 對象，然後傳回該物件。 然後，控件的 EditorPart 集合會指派給 EditorParts 區域的 屬性 EditorZoneBase 。

注意

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

給實施者的注意事項

EditorPartCollection方法傳回的對像是CreateEditorParts()只讀的，而且沒有可存取的方法可將個別控件加入其中。 不過，在方法的覆寫或實作中，您可以建立另一種 ICollection 物件，例如 ArrayList，以包含所有自定義 EditorPart 控件，並在建立新 EditorPartCollection 物件時將它傳遞至建構函式。 如需程式代碼範例，請參閱一節。

另請參閱

• EditorPart
• ASP.NET 網頁元件控制件