IWebEditable.CreateEditorParts 方法

定义

返回实现 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,包含服务器控件的关联自定义 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

注意

添加到方法实现CreateEditorParts中控件集合EditorPart的任何EditorPart都必须具有分配给其 ID 属性的值,否则,当集合分配给属性EditorParts时,将引发异常。

实施者说明

该方法 EditorPartCollection 返回的对象 CreateEditorParts() 是只读的,没有可访问的方法可向其添加单个控件。 但是,在方法的重写或实现中,可以创建另一种 ICollection 对象(如 ArrayList),以包含所有自定义 EditorPart 控件,并在创建新 EditorPartCollection 对象时将其传递给构造函数。 有关代码示例,请参阅示例部分。

适用于

另请参阅