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