ScriptManager.RegisterDispose(Control, String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Regista um dispose script para um controlo que está dentro de um UpdatePanel controlo. O script é executado quando o UpdatePanel controlo é atualizado ou eliminado.
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 controlo para o qual o dispose guião serve.
- disposeScript
- String
O dispose guião.
Exceções
Observações
Use o RegisterDispose método para registar dispose scripts para controlos que estão dentro de um UpdatePanel controlo. Durante os postbacks assíncronos, UpdatePanel os controlos podem ser atualizados, eliminados ou criados. Quando um painel é atualizado ou eliminado, quaisquer dispose scripts registados para controlos dentro do UpdatePanel são chamados. Em cenários típicos de desenvolvimento de página, não é necessário chamar o RegisterDispose processo.
O RegisterDispose método destina-se a ser utilizado por programadores de controlo para registar scripts ou criar controlos que herdam da IScriptControl interface. Por exemplo, pode usar um dispose guião se desenvolver um controlo do cliente usando composição. No teu controlo, implementas IScriptControl e renderizas controlos individuais. Regista o dispose método de qualquer item que não corresponda a um componente cliente definido, como Sys.TextBox. Se o seu controlo personalizado compor elementos que correspondem a componentes do cliente na Microsoft Ajax Library, não precisa de registar um script dispose, porque o dispose é chamado automaticamente. Por isso, utilize o método RegisterDispose para componentes clientes que fazem parte da Microsoft Ajax Library e que têm de libertar recursos quando um componente deixa de ser utilizado.
O RegisterDispose método pode ser chamado várias vezes para um controlo. Múltiplos scripts são agregados. A ordem de descarte dos scripts corresponde à ordem em que os scripts foram registados.
Se registar um dispose script para um controlo que não está num UpdatePanel controlo, é lançada uma exceção. O dispose guião é chamado entre os pageLoading eventos e pageLoaded da PageRequestManager turma.