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 dispose script para un control que está dentro de un UpdatePanel control . El script se ejecuta cuando el UpdatePanel control 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 para el que está el dispose script.
- disposeScript
- String
El dispose script.
Excepciones
Comentarios
Use el RegisterDispose método para registrar dispose scripts para los controles que están dentro de un UpdatePanel control. Durante las postbacks asincrónicas, UpdatePanel los controles se pueden actualizar, eliminar o crear. Cuando se actualiza o elimina un panel, dispose se llama a los 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á diseñado para que lo usen los desarrolladores de controles para registrar el script 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. Registra el dispose método de cualquier elemento que no se corresponda con 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 Ajax de Microsoft, no es necesario registrar un script de dispose, ya que se llama automáticamente a dispose. Por lo tanto, use el método RegisterDispose para los componentes cliente que forman parte de la biblioteca de Ajax de Microsoft y que tienen que liberar recursos cuando ya no se usa 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 llama al dispose script entre los pageLoading eventos y pageLoaded de la PageRequestManager clase .