ScriptManager.RegisterDispose(Control, String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Registra un script dispose para un control que está dentro de un control UpdatePanel. Se ejecuta el script cuando el control UpdatePanel se actualiza o elimina.
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)Parámetros
- control
- Control
Control al que va destinado el script dispose.
- disposeScript
- String
Script dispose.
Excepciones
control no se encuentra en la página.
o bien
control no está dentro de un control UpdatePanel.
Comentarios
Use el RegisterDispose método para registrar dispose scripts para los controles que están dentro de un UpdatePanel control. Durante los postbacks asincrónicos, UpdatePanel los controles se pueden actualizar, eliminar o crear. Cuando se actualiza o elimina un panel, se llama a los dispose scripts registrados para los controles que están dentro de .UpdatePanel En escenarios típicos de desarrollo de páginas, no es necesario llamar al RegisterDispose método .
El RegisterDispose método está pensado para que lo usen los desarrolladores de controles para registrar scripts o crear controles que heredan de la IScriptControl interfaz. Por ejemplo, puede usar un dispose script si desarrolla un control de cliente mediante la composición. En el control, implementará IScriptControl y representará controles individuales. Registre el dispose método de cualquier elemento que no corresponda a un componente de cliente definido, como Sys.TextBox. Si el control personalizado compone elementos que corresponden a los componentes de cliente de la biblioteca de Microsoft Ajax, no tiene que registrar un dispose script, porque dispose se llama automáticamente. Por lo tanto, use el RegisterDispose método para los componentes cliente que forman parte de la biblioteca de Microsoft Ajax y que tienen que liberar recursos cuando ya no se use un componente.
Se RegisterDispose puede llamar al método varias veces para un control . Se agregan varios scripts. El orden de eliminación de scripts coincide con el orden en que se registraron los scripts.
Si registra un dispose script para un control que no está en un UpdatePanel control, se produce una excepción. Se dispose llama al script entre los pageLoading eventos y pageLoaded de la PageRequestManager clase .