IExtenderControl Интерфейс

Определение

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

System.Web.UI

Сборка:

System.Web.Extensions.dll

Определяет поведение управляющего элемента-расширителя.

public interface class IExtenderControl

public interface IExtenderControl

type IExtenderControl = interface

Public Interface IExtenderControl

Производный

System.Web.UI.ExtenderControl

Комментарии

Для элементов управления расширителей, производных от ExtenderControl класса, требуется, ScriptManager чтобы элемент управления наследовался на странице. ExtenderControlБазовый класс выполняет явный тест, чтобы убедиться, что ScriptManager элемент управления существует на странице.

Однако если требуется создать элементы управления расширителя и страница не содержит ScriptManager элемент управления, можно создать класс, который реализует IExtenderControl интерфейс напрямую. Кроме того, при создании класса, производного от Control , или при расширении существующего элемента управления, производного от Control , можно реализовать IExtenderControl интерфейс для поддержки функциональности клиента.

IExtenderControlИнтерфейс регистрирует библиотеки скриптов для элемента управления путем вызова GetScriptReferences метода и регистрирует ScriptDescriptor объекты, вызывая GetScriptDescriptors метод. GetScriptDescriptorsМетод возвращает IEnumerable список ScriptDescriptor объектов.

Примечание

При расширении существующего типа элемента управления, производного от WebControl класса, реализуйте IScriptControl интерфейс.

Чтобы создать управляющий элемент-расширитель с помощью реализации IExtenderControl , выполните следующие действия.

• Напишите код для события элемента управления, OnInit чтобы обнаружить и использовать ScriptManager элемент управления, если он доступен на странице.

• Если ScriptManager Страница недоступна, укажите альтернативные средства для регистрации необходимых скриптов путем вызова статических методов ScriptManager класса.

• Укажите защищенные виртуальные члены для IExtenderControl членов.

• Предоставьте скрипт экземпляра в качестве блока скрипта, регистрируемого с помощью ScriptManager элемента управления. Это необходимо сделать во время событий элемента управления PreRender , PreRenderComplete или Render .

• Зарегистрируйте дескрипторы скрипта во время события элемента управления Render .

Примечание

Если страница содержит UpdatePanel элемент управления, страница должна содержать ScriptManager элемент управления. Интерфейс должен быть реализован IExtenderControl только в том случае, если страница не содержит ScriptManager элемент управления.

Методы

GetScriptDescriptors(Control)	Регистрирует объекты ScriptDescriptor для элемента управления и возвращает объект, содержащий объект ScriptDescriptor для элемента управления.
GetScriptReferences()	Регистрирует библиотеки скрипта для элемента управления и возвращает перечисление файлов ECMAScript (JavaScript), зарегистрированных как внедренные ресурсы.

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

• ExtenderControl
• ScriptManager