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