IExtenderControl Schnittstelle

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Definiert das Verhalten für ein Extendersteuerelement.

public interface class IExtenderControl

public interface IExtenderControl

type IExtenderControl = interface

Public Interface IExtenderControl

Abgeleitet

System.Web.UI.ExtenderControl

Hinweise

Extender-Steuerelemente, die von der- ExtenderControl Klasse abgeleitet werden, erfordern ein ScriptManager Steuerelement auf der Seite. Die ExtenderControl Basisklasse führt einen expliziten Test aus, um sicherzustellen, dass ein ScriptManager Steuerelement auf der Seite vorhanden ist.

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. 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.

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. Die- GetScriptDescriptors Methode gibt eine IEnumerable Liste von-Objekten zurück ScriptDescriptor .

Hinweis

Wenn Sie einen vorhandenen Steuerelement Typ erweitern, der von der-Klasse abgeleitet ist WebControl , implementieren Sie die- IScriptControl Schnittstelle.

Zum Erstellen eines Extendersteuerelements durch Implementieren von IExtenderControl führen Sie die folgenden Schritte aus:

• 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.

• 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.

• Stellen Sie geschützte virtuelle Member für IExtenderControl Mitglieder bereit.

• Geben Sie das instanzskript als Skriptblock an, den Sie mit dem-Steuerelement registrieren ScriptManager . Dies muss während der-,-oder-Ereignisse des-Steuer Elements durchzuführen sein PreRender PreRenderComplete Render .

• Registrieren Sie die Skript Deskriptoren während des-Ereignisses des-Steuer Elements Render .

Hinweis

Wenn die Seite ein- UpdatePanel Steuerelement enthält, muss die Seite ein-Steuerelement enthalten ScriptManager . Sie müssen die- IExtenderControl Schnittstelle nur implementieren, wenn die Seite kein-Steuerelement enthält ScriptManager .

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.
GetScriptReferences()	Registriert die Skriptbibliotheken für das Steuerelement und gibt eine Enumeration mit ECMAScript-Dateien (JavaScript) zurück, die als eingebettete Ressourcen registriert wurden.

Siehe auch

• ExtenderControl
• ScriptManager