IExtenderControl Интерфейс

Определение

Определяет поведение управляющего элемента-расширителя.Defines the behavior for an extender control.

public interface class IExtenderControl
public interface IExtenderControl
type IExtenderControl = interface
Public Interface IExtenderControl
Производный

Комментарии

Для элементов управления расширителей, производных ExtenderControl от класса, ScriptManager требуется, чтобы элемент управления наследовался на странице.Extender controls that derive from the ExtenderControl class require a ScriptManager control to be on the page. Базовый класс выполняет явный тест ScriptManager , чтобы убедиться, что элемент управления существует на странице. ExtenderControlThe ExtenderControl base class performs an explicit test to make sure that a ScriptManager control exists on the page.

Однако если требуется создать элементы управления расширителя и страница не содержит ScriptManager элемент управления, можно создать класс, который IExtenderControl реализует интерфейс напрямую.However, if you want to create extender controls and the page does not contain an ScriptManager control, you can create a class that implements the IExtenderControl interface directly. Кроме того, при создании класса, производного от Control IExtenderControl , или при расширении существующего элемента управления, производного от Control, можно реализовать интерфейс для поддержки функциональности клиента.Additionally, if you are creating a class that derives from Control or you are extending an existing control that derives from Control, you can implement the IExtenderControl interface to support client functionality.

Интерфейс регистрирует библиотеки скриптов для элемента управления путем GetScriptReferences вызова метода и GetScriptDescriptors регистрирует ScriptDescriptor объекты, вызывая метод. IExtenderControlThe IExtenderControl interface registers the script libraries for a control by calling the GetScriptReferences method, and it registers ScriptDescriptor objects by calling the GetScriptDescriptors method. GetScriptDescriptors Метод возвращаетScriptDescriptor список объектов. IEnumerableThe GetScriptDescriptors method returns an IEnumerable list of ScriptDescriptor objects.

Примечание

При расширении существующего типа элемента управления, производного от WebControl класса, IScriptControl реализуйте интерфейс.If you extend an existing control type that is derived from the WebControl class, implement the IScriptControl interface.

Чтобы создать управляющий элемент-расширитель с IExtenderControlпомощью реализации, выполните следующие действия.To create an extender control by implementing IExtenderControl, you do the following:

  • Напишите код для OnInit события элемента управления, чтобы обнаружить и ScriptManager использовать элемент управления, если он доступен на странице.Write code for the control's OnInit event to detect and use the ScriptManager control if it is available on the page.

  • Если страница недоступна, укажите альтернативные средства для регистрации необходимых скриптов путем вызова статических методов ScriptManager класса. ScriptManagerIf the ScriptManager is not available on the page, provide alternative means to register required scripts by calling static methods of the ScriptManager class.

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

  • Предоставьте скрипт экземпляра в качестве блока скрипта, регистрируемого с ScriptManager помощью элемента управления.Provide instance script as a script block that you register with the ScriptManager control. Это необходимо сделать во время событий элемента управления PreRender, PreRenderCompleteили Render .You must do this during the control's PreRender, PreRenderComplete, or Render events.

  • Зарегистрируйте дескрипторы скрипта во время Render события элемента управления.Register the script descriptors during the control's Render event.

Примечание

Если страница содержит UpdatePanel элемент управления, страница должна ScriptManager содержать элемент управления.If the page contains an UpdatePanel control, the page must contain a ScriptManager control. IExtenderControl Интерфейс долженScriptManager быть реализован только в том случае, если страница не содержит элемент управления.You must implement the IExtenderControl interface only when the page does not contain a ScriptManager control.

Методы

GetScriptDescriptors(Control)

Регистрирует объекты ScriptDescriptor для элемента управления и возвращает объект, содержащий объект ScriptDescriptor для элемента управления.Registers the ScriptDescriptor objects for the control and returns an object that contains the ScriptDescriptor objects for the control.

GetScriptReferences()

Регистрирует библиотеки скрипта для элемента управления и возвращает перечисление файлов ECMAScript (JavaScript), зарегистрированных как внедренные ресурсы.Registers the script libraries for the control and returns an enumeration of ECMAScript (JavaScript) files that have been registered as embedded resources.

Применяется к

Дополнительно