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