ScriptManager.RegisterDispose(Control, String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Registra um dispose script para um controle que está dentro de um UpdatePanel controle. O script é executado quando o UpdatePanel controle é 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 -> unitPublic Sub RegisterDispose (control As Control, disposeScript As String)Parâmetros
- control
- Control
O controle para o qual o dispose script serve.
- disposeScript
- String
O dispose script.
Exceções
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 ao uso por desenvolvedores de controle para registrar script ou criar controles que herdam da IScriptControl interface. Por exemplo, você poderá usar um dispose script se desenvolver um controle de cliente usando a composição. Em seu 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 Microsoft Ajax, você não precisará registrar um script dispose, pois dispose é chamado automaticamente. Portanto, use o método RegisterDispose para componentes cliente que fazem parte do Microsoft Biblioteca Ajax e que precisam liberar recursos quando um componente não é 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 em que 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á gerada. O dispose script é chamado entre os eventos e pageLoaded os pageLoading eventos da PageRequestManager classe.