IWebEditable.CreateEditorParts 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
回傳一組與實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.EditorPartCollectionPublic Function CreateEditorParts () As EditorPartCollection傳回
一個 EditorPartCollection 包含與伺服器控制相關聯的自訂 EditorPart 控制集合。
範例
以下程式碼範例示範了在自訂CreateEditorParts控制中覆寫該WebPart方法的方法。 執行範例所需的完整原始碼可在類別概述主題的 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 方法允許您建立所有 EditorPart 與自訂控制 WebPart 項、控制項或使用者控制項相關的集合，並以物件形式回傳 EditorPartCollection 。 控制項 WebPartManager 會接收集合，並在伺服器控制項進入編輯模式時建立所有 EditorPart 控制項的實例。
通常你會透過覆寫它的方法WebPart，在自訂CreateEditorParts控制中實作此方法。 在這個方法裡，你會建立你想與控制項關聯的自訂 EditorPart 控制項實例，將它們加入物件 EditorPartCollection ，然後回傳該物件。 EditorPart控制組接著被分配到EditorParts該區域的EditorZoneBase屬性。
Note
在方法實作EditorPart中，任何EditorPart加入控制項集合CreateEditorParts的 ID 屬性都必須有值，否則當集合被指派到該EditorParts屬性時，會拋出例外。
給實施者的注意事項
方法回EditorPartCollection傳的CreateEditorParts()物件是唯讀的，沒有可存取的方法來新增個別控制項。 然而，在你覆蓋或實作該方法時，你可以建立另一種物件 ICollection ，例如 ArrayList一個，來包含所有自訂 EditorPart 控制項，並在建立新 EditorPartCollection 物件時將其傳給建構子。 關於程式碼範例，請參見範例章節。
