Compartilhar via


ScriptManager.RegisterDispose(Control, String) Método

Definição

Registra um script dispose para um controle que está em um controle UpdatePanel. O script é executado quando o controle UpdatePanel é atualizado ou excluído.

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.

disposeScript
String

O script dispose.

Exceções

control é null.

- ou - disposeScript é null.

O control não foi encontrado na página.

- ou - O control não está em um controle UpdatePanel.

Comentários

Use o RegisterDispose método para registrar dispose scripts para controles que estão dentro de um UpdatePanel controle. Durante postbacks assíncronos, UpdatePanel os controles podem ser atualizados, excluídos ou criados. Quando um painel é atualizado ou excluído, todos dispose os scripts registrados para controles que estão dentro do UpdatePanel são chamados. Em cenários típicos de desenvolvimento de página, você não precisa chamar o RegisterDispose método.

O RegisterDispose método destina-se a ser usado por desenvolvedores de controle para registrar script ou criar controles que herdam da IScriptControl interface. Por exemplo, você pode usar um dispose script se desenvolver um controle de cliente usando composição. No controle, você implementa IScriptControl e renderiza controles individuais. Registre o dispose método de qualquer item que não corresponda a um componente de cliente definido, como Sys.TextBox. Se o 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 será chamado automaticamente. Portanto, use o RegisterDispose método para componentes de cliente que fazem parte da Biblioteca do Microsoft Ajax e que precisam liberar recursos quando um componente não for mais usado.

O RegisterDispose método pode ser chamado várias vezes para um controle. Vários scripts são agregados. A ordem de descartar scripts corresponde à ordem na qual os scripts foram registrados.

Se você registrar um dispose script para um controle que não está em um UpdatePanel controle, uma exceção será lançada. O dispose script é chamado entre os eventos e pageLoaded os pageLoading eventos da PageRequestManager classe.

Aplica-se a

Confira também