IExtenderControl Schnittstelle

Definition

Definiert das Verhalten für ein Extendersteuerelement.Defines the behavior for an extender control.

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

Hinweise

Extender-Steuerelemente, die von der- ExtenderControl Klasse abgeleitet werden, erfordern ein ScriptManager Steuerelement auf der Seite.Extender controls that derive from the ExtenderControl class require a ScriptManager control to be on the page. Die ExtenderControl Basisklasse führt einen expliziten Test aus, um sicherzustellen, dass ein ScriptManager Steuerelement auf der Seite vorhanden ist.The ExtenderControl base class performs an explicit test to make sure that a ScriptManager control exists on the page.

Wenn Sie jedoch Extender-Steuerelemente erstellen möchten und die Seite kein-Steuerelement enthält ScriptManager , können Sie eine Klasse erstellen, die die- IExtenderControl Schnittstelle direkt implementiert.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. Wenn Sie eine Klasse erstellen, die von abgeleitet wird, Control oder wenn Sie ein vorhandenes Steuerelement erweitern, das von abgeleitet Control wird, können Sie die- IExtenderControl Schnittstelle implementieren, um die Client Funktionalität zu unterstützen.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.

Die- IExtenderControl Schnittstelle registriert die Skript Bibliotheken für ein-Steuerelement durch Aufrufen der GetScriptReferences -Methode, und registriert- ScriptDescriptor Objekte durch Aufrufen der- GetScriptDescriptors Methode.The IExtenderControl interface registers the script libraries for a control by calling the GetScriptReferences method, and it registers ScriptDescriptor objects by calling the GetScriptDescriptors method. Die- GetScriptDescriptors Methode gibt eine IEnumerable Liste von-Objekten zurück ScriptDescriptor .The GetScriptDescriptors method returns an IEnumerable list of ScriptDescriptor objects.

Hinweis

Wenn Sie einen vorhandenen Steuerelement Typ erweitern, der von der-Klasse abgeleitet ist WebControl , implementieren Sie die- IScriptControl Schnittstelle.If you extend an existing control type that is derived from the WebControl class, implement the IScriptControl interface.

Zum Erstellen eines Extendersteuerelements durch Implementieren von IExtenderControl führen Sie die folgenden Schritte aus:To create an extender control by implementing IExtenderControl, you do the following:

  • Schreiben Sie Code für das-Ereignis des Steuer Elements OnInit , um das Steuerelement zu erkennen und zu verwenden, ScriptManager Wenn es auf der Seite verfügbar ist.Write code for the control's OnInit event to detect and use the ScriptManager control if it is available on the page.

  • Wenn der ScriptManager auf der Seite nicht verfügbar ist, stellen Sie alternative Möglichkeiten zum Registrieren erforderlicher Skripts bereit, indem Sie statische Methoden der- ScriptManager Klasse aufrufen.If the ScriptManager is not available on the page, provide alternative means to register required scripts by calling static methods of the ScriptManager class.

  • Stellen Sie geschützte virtuelle Member für IExtenderControl Mitglieder bereit.Provide protected virtual members for IExtenderControl members.

  • Geben Sie das instanzskript als Skriptblock an, den Sie mit dem-Steuerelement registrieren ScriptManager .Provide instance script as a script block that you register with the ScriptManager control. Dies muss während der-,-oder-Ereignisse des-Steuer Elements durchzuführen sein PreRender PreRenderComplete Render .You must do this during the control's PreRender, PreRenderComplete, or Render events.

  • Registrieren Sie die Skript Deskriptoren während des-Ereignisses des-Steuer Elements Render .Register the script descriptors during the control's Render event.

Hinweis

Wenn die Seite ein- UpdatePanel Steuerelement enthält, muss die Seite ein-Steuerelement enthalten ScriptManager .If the page contains an UpdatePanel control, the page must contain a ScriptManager control. Sie müssen die- IExtenderControl Schnittstelle nur implementieren, wenn die Seite kein-Steuerelement enthält ScriptManager .You must implement the IExtenderControl interface only when the page does not contain a ScriptManager control.

Methoden

GetScriptDescriptors(Control)

Registriert die ScriptDescriptor-Objekte für das Steuerelement und gibt ein Objekt zurück, das die ScriptDescriptor-Objekte für das Steuerelement enthält.Registers the ScriptDescriptor objects for the control and returns an object that contains the ScriptDescriptor objects for the control.

GetScriptReferences()

Registriert die Skriptbibliotheken für das Steuerelement und gibt eine Enumeration mit ECMAScript-Dateien (JavaScript) zurück, die als eingebettete Ressourcen registriert wurden.Registers the script libraries for the control and returns an enumeration of ECMAScript (JavaScript) files that have been registered as embedded resources.

Gilt für:

Siehe auch