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

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 对象时将其传递给构造函数。 有关代码示例,请参阅“示例”部分。

适用于

另请参阅