IExtenderControl Interfejs

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.Extensions.dll

Definiuje zachowanie kontrolki Extender.

public interface class IExtenderControl
public interface IExtenderControl
type IExtenderControl = interface
Public Interface IExtenderControl
Pochodne

Uwagi

Formanty rozszerzające pochodne od ExtenderControl klasy wymagają ScriptManager kontrolki na stronie. ExtenderControlKlasa bazowa wykonuje jawny test, aby upewnić się, że ScriptManager kontrolka istnieje na stronie.

Jeśli jednak chcesz utworzyć kontrolki rozszerzające, a strona nie zawiera ScriptManager kontrolki, można utworzyć klasę, która implementuje IExtenderControl interfejs bezpośrednio. Ponadto, jeśli tworzysz klasę, która pochodzi z Control lub rozszerzając istniejący formant pochodzący z Control , można zaimplementować IExtenderControl interfejs do obsługi funkcji klienta.

IExtenderControlInterfejs rejestruje biblioteki skryptów dla kontrolki przez wywołanie GetScriptReferences metody i rejestruje ScriptDescriptor obiekty przez wywołanie GetScriptDescriptors metody. GetScriptDescriptorsMetoda zwraca IEnumerable listę ScriptDescriptor obiektów.

Uwaga

W przypadku rozszerzonego typu formantu, który jest pochodną WebControl klasy, należy zaimplementować IScriptControl interfejs.

Aby utworzyć kontrolkę rozszerzenia przez implementację IExtenderControl , należy wykonać następujące czynności:

  • Napisz kod dla zdarzenia kontrolki OnInit do wykrywania i używania ScriptManager kontrolki, jeśli jest ona dostępna na stronie.

  • Jeśli ScriptManager nie jest dostępna na stronie, podaj alternatywną metodę rejestrowania wymaganych skryptów przez wywoływanie metod statycznych ScriptManager klasy.

  • Zapewnianie chronionym wirtualnym członkom IExtenderControl elementów członkowskich.

  • Podaj skrypt wystąpienia jako blok skryptu zarejestrowanego w ScriptManager kontrolce. Należy to zrobić podczas kontrolki PreRender , PreRenderComplete , lub Render zdarzenia.

  • Zarejestruj deskryptory skryptu podczas zdarzenia kontrolki Render .

Uwaga

Jeśli strona zawiera UpdatePanel kontrolkę, strona musi zawierać ScriptManager kontrolkę. Interfejs należy zaimplementować IExtenderControl tylko wtedy, gdy strona nie zawiera ScriptManager kontrolki.

Metody

GetScriptDescriptors(Control)

Rejestruje ScriptDescriptor obiekty dla kontrolki i zwraca obiekt, który zawiera ScriptDescriptor obiekty dla kontrolki.
GetScriptReferences()

Rejestruje biblioteki skryptów dla kontrolki i zwraca Wyliczenie plików ECMAScript (JavaScript), które zostały zarejestrowane jako osadzone zasoby.

Dotyczy

Zobacz też