ScriptManager.RegisterDispose(Control, String) Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.Extensions.dll

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 -> unit

Public 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

ArgumentNullException

control es null.

O bien disposeScript es null.

ArgumentException

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 .

Consulte también

• IScriptControl