ScriptManager.RegisterDispose(Control, String) Método
Definição
Registra um script dispose para um controle que está em um controle UpdatePanel.Registers a dispose script for a control that is inside an UpdatePanel control. O script é executado quando o controle UpdatePanel é atualizado ou excluído.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
Public Sub RegisterDispose (control As Control, disposeScript As String)
Parâmetros
- control
- Control
O controle ao qual o script dispose se destina.The control that the dispose script is for.
- disposeScript
- String
O script dispose.The dispose script.
Exceções
control é null.control is null.
- ou --or-
disposeScript é null.disposeScript is null.
O control não foi encontrado na página.control is not found on the page.
- ou --or-
O control não está em um controle UpdatePanel.control is not inside an UpdatePanel control.
Comentários
Use o RegisterDispose método para registrar dispose scripts para controles que estão dentro de um UpdatePanel controle.Use the RegisterDispose method to register dispose scripts for controls that are inside an UpdatePanel control. Durante postbacks assíncronos, os UpdatePanel controles podem ser atualizados, excluídos ou criados.During asynchronous postbacks, UpdatePanel controls can be updated, deleted, or created. Quando um painel é atualizado ou excluído, todos os dispose scripts registrados para controles que estão dentro do UpdatePanel são chamados.When a panel is updated or deleted, any dispose scripts that are registered for controls that are inside the UpdatePanel are called. Em cenários de desenvolvimento de página típicos, você não precisa chamar o RegisterDispose método.In typical page development scenarios, you do not have to call the RegisterDispose method.
O RegisterDispose método destina-se ao uso pelos desenvolvedores de controle para registrar script ou criar controles que herdam da IScriptControl interface.The RegisterDispose method is intended for use by control developers to register script or create controls that inherit from the IScriptControl interface. Por exemplo, você pode usar um dispose script se desenvolver um controle de cliente usando composição.For example, you might use a dispose script if you develop a client control by using composition. No seu controle, você implementa IScriptControl e renderiza controles individuais.In your control, you implement IScriptControl and render individual controls. Você registra o dispose método de qualquer item que não corresponda a um 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. Se seu controle personalizado compor elementos que correspondem aos componentes do cliente na biblioteca do Microsoft Ajax, você não precisará registrar um dispose script, pois dispose é chamado automaticamente.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. Portanto, use o RegisterDispose método para componentes cliente que fazem parte da biblioteca do Microsoft Ajax e que precisam liberar recursos quando um componente não for mais usado.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.
O RegisterDispose método pode ser chamado várias vezes para um controle.The RegisterDispose method can be called multiple times for a control. Vários scripts são agregados.Multiple scripts are aggregated. A ordem de descarte de scripts corresponde à ordem em que os scripts foram registrados.The order of disposing scripts matches the order in which the scripts were registered.
Se você registrar um dispose script para um controle que não está em um UpdatePanel controle, uma exceção será lançada.If you register a dispose script for a control that is not in an UpdatePanel control, an exception is thrown. O dispose script é chamado entre os pageLoading pageLoaded eventos e da PageRequestManager classe.The dispose script is called between the pageLoading and pageLoaded events of the PageRequestManager class.