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 элементов управления, связанных с серверным элементом управления.
Примеры
В следующем примере кода демонстрируется переопределение 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 зоны.
Замечание
Любое EditorPart , которое добавляется в коллекцию EditorPart элементов управления в реализации CreateEditorParts метода, должно иметь значение, назначенное свойству идентификатора, в противном случае исключение будет возникать при назначении коллекции свойству EditorParts .
Примечания для тех, кто реализует этот метод
Объект, EditorPartCollectionCreateEditorParts() возвращаемый методом, доступен только для чтения и не имеет доступных методов для добавления в него отдельных элементов управления. Однако в переопределении или реализации метода можно создать другой тип ICollection объекта, например ArrayListобъект, содержащий все пользовательские EditorPart элементы управления, и передать его конструктору при создании нового EditorPartCollection объекта. Пример кода см. в разделе "Пример".