Condividi tramite


ScriptManager.RegisterDispose(Control, String) Metodo

Definizione

Registra uno script dispose per un controllo compreso in un controllo UpdatePanel. Lo script viene eseguito quando il controllo UpdatePanel viene aggiornato o eliminato.

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)

Parametri

control
Control

Controllo a cui è destinato lo script dispose.

disposeScript
String

Script dispose.

Eccezioni

control è null.

-oppure- disposeScript è null.

controlnon viene trovato nella pagina.

-oppure- controlnon è compreso in un controllo UpdatePanel.

Commenti

Utilizzare il RegisterDispose metodo per registrare dispose gli script per i controlli che si trovano all'interno di un UpdatePanel controllo . Durante i postback asincroni, UpdatePanel i controlli possono essere aggiornati, eliminati o creati. Quando un pannello viene aggiornato o eliminato, vengono chiamati gli dispose script registrati per i controlli all'interno di UpdatePanel . Negli scenari di sviluppo di pagine tipici non è necessario chiamare il RegisterDispose metodo .

Il RegisterDispose metodo è destinato all'uso da parte degli sviluppatori di controlli per registrare script o creare controlli che ereditano dall'interfaccia IScriptControl . Ad esempio, è possibile usare uno dispose script se si sviluppa un controllo client usando la composizione. Nel controllo si implementano IScriptControl ed eseguono il rendering di singoli controlli. Si registra il dispose metodo di qualsiasi elemento che non corrisponde a un componente client definito, Sys.TextBoxad esempio . Se il controllo personalizzato compone elementi che corrispondono ai componenti client nella libreria Microsoft Ajax, non è necessario registrare uno dispose script, perché dispose viene chiamato automaticamente. Usare quindi il RegisterDispose metodo per i componenti client che fanno parte della libreria Microsoft Ajax e che devono liberare risorse quando un componente non viene più usato.

Il RegisterDispose metodo può essere chiamato più volte per un controllo . Vengono aggregati più script. L'ordine di eliminazione degli script corrisponde all'ordine in cui sono stati registrati gli script.

Se si registra uno dispose script per un controllo che non si trova in un UpdatePanel controllo, viene generata un'eccezione. Lo dispose script viene chiamato tra gli pageLoading eventi e pageLoaded della PageRequestManager classe .

Si applica a

Vedi anche