ScriptManager.RegisterDispose(Control, String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Registra uno dispose script per un controllo che si trova all'interno di un UpdatePanel controllo . Lo script viene eseguito quando il UpdatePanel controllo 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 -> unitPublic Sub RegisterDispose (control As Control, disposeScript As String)Parametri
- control
- Control
Controllo per il quale lo dispose script è destinato.
- disposeScript
- String
Script dispose .
Eccezioni
control non viene trovato nella pagina.
oppure
control non è all'interno di un UpdatePanel controllo.
Commenti
Utilizzare il RegisterDispose metodo per registrare dispose 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 ed eseguono IScriptControl 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 script dispose, perché viene chiamato automaticamente dispose. Usare pertanto il metodo RegisterDispose 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 .