IExtenderControl Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Definiert das Verhalten für ein Extendersteuerelement.
public interface class IExtenderControlpublic interface IExtenderControltype IExtenderControl = interfacePublic Interface IExtenderControl- Abgeleitet
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
PreRenderPreRenderCompleteRender.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. |