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, добавляемый в коллекцию, не имеет значения, заданного для свойства 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 возникнет исключение.
