IWebEditable.CreateEditorParts Метод

Определение

Пространство имен:

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

Возвращает коллекцию настраиваемых элементов управления 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

Объект 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 объекта. Пример кода см. в разделе Пример.

См. также раздел

• EditorPart
• элементы управления веб-частей ASP.NET