ScriptManager.RegisterDispose(Control, String) ScriptManager.RegisterDispose(Control, String) ScriptManager.RegisterDispose(Control, String) Method

Definición

Registra un script dispose para un control que está dentro de un control UpdatePanel.Registers a dispose script for a control that is inside an UpdatePanel control. Se ejecuta el script cuando el control UpdatePanel se actualiza o elimina.The script is executed when the UpdatePanel control is updated or deleted.

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

Parámetros

control
Control Control Control

Control al que va destinado el script dispose.The control that the dispose script is for.

disposeScript
String String String

Script dispose.The dispose script.

Excepciones

control es null.control is null.

O bien-or- disposeScript es null.disposeScript is null.

control no se encuentra en la página.control is not found on the page.

O bien-or- control no está dentro de un control UpdatePanel.control is not inside an UpdatePanel control.

Comentarios

Use la RegisterDispose método para registrar dispose secuencias de comandos para los controles que están dentro de un UpdatePanel control.Use the RegisterDispose method to register dispose scripts for controls that are inside an UpdatePanel control. Durante los postbacks asincrónicos, UpdatePanel controles se pueden actualizar, eliminar o creados.During asynchronous postbacks, UpdatePanel controls can be updated, deleted, or created. Cuando un panel se actualiza o elimina, cualquier dispose scripts que se registran para los controles que están dentro de la UpdatePanel se denominan.When a panel is updated or deleted, any dispose scripts that are registered for controls that are inside the UpdatePanel are called. En escenarios de desarrollo de páginas normales, no es necesario llamar a la RegisterDispose método.In typical page development scenarios, you do not have to call the RegisterDispose method.

El RegisterDispose método está pensado para su uso por los desarrolladores de controles para registrar scripts o crear controles que heredan de la IScriptControl interfaz.The RegisterDispose method is intended for use by control developers to register script or create controls that inherit from the IScriptControl interface. Por ejemplo, podría usar un dispose si desarrolla un control de cliente utilizando la composición de secuencias de comandos.For example, you might use a dispose script if you develop a client control by using composition. En el control, puede implementar IScriptControl y representar los controles individuales.In your control, you implement IScriptControl and render individual controls. Registrar el dispose método de cualquier elemento que no corresponde a un componente de cliente definido como Sys.TextBox.You register the dispose method of any item that does not correspond to a defined client component such as Sys.TextBox. Si el control personalizado compone elementos que corresponden a los componentes de cliente de Microsoft Ajax Library, es necesario registrar un dispose en el script, porque dispose se llama automáticamente.If your custom control composes elements that correspond to client components in the Microsoft Ajax Library, you do not have to register a dispose script, because dispose is called automatically. Por lo tanto, use el RegisterDispose método para los componentes que forman parte de Microsoft Ajax Library y que tienen que liberar recursos cuando ya no se utiliza un componente de cliente.Therefore, use the RegisterDispose method for client components that are part of the Microsoft Ajax Library and that have to free resources when a component is no longer used.

El RegisterDispose método puede llamarse varias veces para un control.The RegisterDispose method can be called multiple times for a control. Se agregan varias secuencias de comandos.Multiple scripts are aggregated. El orden de los scripts de eliminación coincide con el orden en el que se registraron las secuencias de comandos.The order of disposing scripts matches the order in which the scripts were registered.

Si registra un dispose script para un control que no está en un UpdatePanel control, se produce una excepción.If you register a dispose script for a control that is not in an UpdatePanel control, an exception is thrown. El dispose script se llama entre la pageLoading y pageLoaded eventos de la PageRequestManager clase.The dispose script is called between the pageLoading and pageLoaded events of the PageRequestManager class.

Se aplica a

Consulte también: