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 。
备注
EditorPart在方法实现CreateEditorParts中添加到控件集合EditorPart中的任何内容都必须为其 ID 属性赋值,否则在将集合分配给EditorParts该属性时将引发异常。
实施者说明
该方法 EditorPartCollection 返回的对象 CreateEditorParts() 是只读的,并且没有可访问的方法向其添加单个控件。 但是,在方法的重写或实现中,可以创建另一种 ICollection 对象,例如, ArrayList包含所有自定义 EditorPart 控件,并在创建新 EditorPartCollection 对象时将其传递给构造函数。 有关代码示例,请参阅“示例”部分。