EditorZoneBase.EditorParts Свойство

Определение

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

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

Получает коллекцию всех элементов управления EditorPart, содержащихся в зоне EditorZoneBase.

public:
 property System::Web::UI::WebControls::WebParts::EditorPartCollection ^ EditorParts { System::Web::UI::WebControls::WebParts::EditorPartCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.EditorPartCollection EditorParts { get; }

[<System.ComponentModel.Browsable(false)>]
member this.EditorParts : System.Web.UI.WebControls.WebParts.EditorPartCollection

Public ReadOnly Property EditorParts As EditorPartCollection

Значение свойства

EditorPartCollection

Коллекция EditorPartCollection, содержащая все отдельные элементы управления EditorPart в зоне.

Атрибуты

BrowsableAttribute

Исключения

InvalidOperationException

Объект EditorPart, добавляемый в коллекцию, не имеет значения, заданного для свойства ID.

Примеры

В следующем примере кода показано, как получить доступ к свойству EditorParts программным способом. Полный код, необходимый для выполнения примера, см. в разделе EditorZoneBase Пример раздела обзора класса.

В первой части примера кода показано, что EditorParts свойство содержит ссылки на все EditorPart элементы управления, на которые на веб-странице ссылаются декларативно.

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

Вторая часть примера кода программно обращается к свойству EditorParts и перечисляет идентификаторы каждого элемента управления в элементе Label управления.

void Button3_Click(object sender, EventArgs e)
{
  Label1.Text = "<br />";
  foreach (EditorPart part in EditorZone1.EditorParts)
  {
    Label1.Text += part.ID + "<br />";
  }
}

Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
  Label1.Text = "<br />"
  Dim part As EditorPart
  For Each part In EditorZone1.EditorParts
    Label1.Text += part.ID + "<br />"
  Next part
End Sub

При загрузке страницы в браузере можно нажать кнопку Display EditorParts Collection (Показать редактор)Коллекция элементов, чтобы получить список идентификаторов всех EditorPart элементов управления, на которые ссылается EditorParts свойство .

Комментарии

Свойство EditorParts предоставляет ссылку на коллекцию всех EditorPart элементов управления в зоне. Он ссылается как на EditorPart элементы управления, предоставляемые с набором элементов управления веб-частей, так и на все пользовательские EditorPart элементы управления, добавленные в зону. Так как коллекция доступна только для чтения, разработчики, которые хотят создать пользовательские EditorPart элементы управления для общих целей редактирования и добавить их в коллекцию, должны переопределить CreateEditorParts метод .

При разработке пользовательских EditorPart элементов управления для изменения определенного WebPartIWebEditable элемента управления необходимо переопределить элементы интерфейса — CreateEditorParts метод и WebBrowsableObject свойство — в элементе WebPart управления . Причина переопределения этих элементов заключается в том, чтобы позволить элементу WebPart управления создавать пользовательские EditorPart элементы управления и добавлять их в коллекцию EditorParts при редактировании элемента управления, а также предоставлять элементам управления редактирования ссылку WebPart на объект, который они редактируют. Если вы хотите добавить пользовательский EditorPart элемент управления для изменения серверного элемента управления, который не наследуется от WebPart класса , необходимо реализовать IWebEditable интерфейс в классе так же, как и для WebPart элемента управления .

Примечание

Обратите внимание, что любому EditorPart объекту, добавляемому в коллекцию EditorPart элементов управления в реализации CreateEditorParts метода, должно быть присвоено значение его свойству ID, в противном случае при назначении коллекции свойству EditorParts будет выдано исключение.

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

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