IExtenderControl Interface

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Définit le comportement pour un contrôle d'extendeur.

public interface class IExtenderControl

public interface IExtenderControl

type IExtenderControl = interface

Public Interface IExtenderControl

Dérivé

System.Web.UI.ExtenderControl

Remarques

Les contrôles d’extendeur qui dérivent de la ExtenderControl classe requièrent qu’un ScriptManager contrôle soit sur la page. La ExtenderControl classe de base effectue un test explicite pour s’assurer qu’un ScriptManager contrôle existe sur la page.

Toutefois, si vous souhaitez créer des contrôles d’extendeur et que la page ne contient pas de ScriptManager contrôle, vous pouvez créer une classe qui implémente IExtenderControl directement l’interface. En outre, si vous créez une classe qui dérive de Control ou si vous étendez un contrôle existant qui dérive de Control , vous pouvez implémenter l' IExtenderControl interface pour prendre en charge les fonctionnalités du client.

L' IExtenderControl interface enregistre les bibliothèques de scripts pour un contrôle en appelant la GetScriptReferences méthode, et enregistre les ScriptDescriptor objets en appelant la GetScriptDescriptors méthode. La GetScriptDescriptors méthode retourne une IEnumerable liste d' ScriptDescriptor objets.

Notes

Si vous étendez un type de contrôle existant dérivé de la WebControl classe, implémentez l' IScriptControl interface.

Pour créer un contrôle d’extendeur en implémentant IExtenderControl , vous procédez comme suit :

• Écrivez du code pour l’événement du contrôle OnInit afin de détecter et d’utiliser le ScriptManager contrôle s’il est disponible sur la page.

• Si le ScriptManager n’est pas disponible sur la page, fournissez d’autres moyens pour inscrire les scripts requis en appelant des méthodes statiques de la ScriptManager classe.

• Fournissez des membres virtuels protégés pour les IExtenderControl membres.

• Fournissez un script d’instance sous la forme d’un bloc de script que vous enregistrez avec le ScriptManager contrôle. Vous devez effectuer cette opération pendant les PreRender événements, PreRenderComplete ou du contrôle Render .

• Inscrire les descripteurs de script pendant l’événement du contrôle Render .

Notes

Si la page contient un UpdatePanel contrôle, la page doit contenir un ScriptManager contrôle. Vous devez implémenter l' IExtenderControl interface uniquement lorsque la page ne contient pas de ScriptManager contrôle.

Méthodes

GetScriptDescriptors(Control)	Enregistre les objets ScriptDescriptor du contrôle et retourne un objet qui contient les objets ScriptDescriptor du contrôle.
GetScriptReferences()	Enregistre les bibliothèques de scripts pour le contrôle et retourne une énumération des fichiers ECMAScript (JavaScript) qui ont été enregistrés en tant que ressources incorporées.

Voir aussi

• ExtenderControl
• ScriptManager