ScriptManager.RegisterDispose(Control, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Inscrit un script dispose pour un contrôle situé à l'intérieur d'un contrôle UpdatePanel. Le script est exécuté quand le contrôle UpdatePanel est mis à jour ou supprimé.
public:
void RegisterDispose(System::Web::UI::Control ^ control, System::String ^ disposeScript);public void RegisterDispose (System.Web.UI.Control control, string disposeScript);member this.RegisterDispose : System.Web.UI.Control * string -> unitPublic Sub RegisterDispose (control As Control, disposeScript As String)Paramètres
- control
- Control
Contrôle auquel est destiné le script dispose.
- disposeScript
- String
Script dispose.
Exceptions
controlest introuvable sur la page.
- ou -
controln'est pas à l'intérieur d'un contrôle UpdatePanel.
Remarques
Utilisez la RegisterDispose méthode pour inscrire dispose des scripts pour les contrôles qui se trouvent à l’intérieur d’un UpdatePanel contrôle. Pendant les postbacks asynchrones, UpdatePanel les contrôles peuvent être mis à jour, supprimés ou créés. Lorsqu’un panneau est mis à jour ou supprimé, tous les dispose scripts inscrits pour les contrôles qui se trouvent dans le panneau UpdatePanel sont appelés. Dans les scénarios de développement de pages classiques, vous n’avez pas besoin d’appeler la RegisterDispose méthode.
La RegisterDispose méthode est destinée aux développeurs de contrôles pour inscrire un script ou créer des contrôles qui héritent de l’interface IScriptControl . Par exemple, vous pouvez utiliser un dispose script si vous développez un contrôle client à l’aide de la composition. Dans votre contrôle, vous implémentez et affichez IScriptControl des contrôles individuels. Vous inscrivez la dispose méthode d’un élément qui ne correspond pas à un composant client défini tel que Sys.TextBox. Si votre contrôle personnalisé compose des éléments qui correspondent aux composants clients de la bibliothèque Microsoft Ajax, vous n’avez pas besoin d’inscrire un dispose script, car dispose il est appelé automatiquement. Par conséquent, utilisez la RegisterDispose méthode pour les composants clients qui font partie de la bibliothèque Microsoft Ajax et qui doivent libérer des ressources lorsqu’un composant n’est plus utilisé.
La RegisterDispose méthode peut être appelée plusieurs fois pour un contrôle. Plusieurs scripts sont agrégés. L’ordre de suppression des scripts correspond à l’ordre dans lequel les scripts ont été inscrits.
Si vous inscrivez un dispose script pour un contrôle qui n’est pas dans un UpdatePanel contrôle, une exception est levée. Le dispose script est appelé entre les événements et pageLoaded les pageLoading événements de la PageRequestManager classe.