EditorZoneBase.EditorParts Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает коллекцию всех элементов управления, 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.EditorPartCollectionPublic ReadOnly Property EditorParts As EditorPartCollectionЗначение свойства
Объект, EditorPartCollection содержащий все отдельные EditorPart элементы управления в зоне.
- Атрибуты
Исключения
Добавленный EditorPart в коллекцию объект не имеет значения, присвоенного свойству идентификатора.
Примеры
В следующем примере кода показано, как получить доступ к свойству 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
При загрузке страницы в браузере можно нажать кнопку "Коллекция редакторов отображения ", чтобы отобразить идентификаторы всех EditorPart элементов управления, на которые ссылается свойство EditorParts .
Комментарии
Свойство EditorParts предоставляет ссылку на коллекцию всех EditorPart элементов управления в зоне. Он ссылается как на EditorPart элементы управления, предоставляемые набором элементов управления веб-частей, так и на все пользовательские EditorPart элементы управления, которые добавляются в зону. Так как коллекция доступна только для чтения, разработчики, которые хотят создавать пользовательские EditorPart элементы управления для общих целей редактирования и добавлять их в коллекцию, должны переопределить CreateEditorParts метод.
При проектировании пользовательских EditorPart элементов управления для изменения определенного IWebEditableWebPart элемента управления необходимо переопределить элементы интерфейса - CreateEditorParts метод и WebBrowsableObject свойство в элементе WebPart управления. Причина переопределения этих элементов заключается в том, чтобы разрешить WebPart элементу управления создавать пользовательские EditorPart элементы управления и добавлять их в EditorParts коллекцию при изменении элемента управления и предоставлять элементы управления редактирования ссылкой на объект, WebPart на который они редактируются. Если вы хотите добавить пользовательский EditorPart элемент управления для изменения серверного элемента управления, который не наследуется от WebPart класса, необходимо реализовать IWebEditable интерфейс в классе так же, как и для WebPart элемента управления.
Замечание
Обратите внимание, что любой EditorPart элемент управления, добавленный в коллекцию EditorPart элементов управления в реализации CreateEditorParts метода, должен иметь значение, назначенное свойству идентификатора, в противном случае исключение будет возникать при назначении коллекции свойству EditorParts .
