Classe Sys.Application

Aggiornamento: novembre 2007

Fornisce un oggetto runtime che espone eventi client e gestisce componenti client che sono registrati con l'applicazione. I membri di questo oggetto sono disponibili globalmente dopo che l'applicazione client è stata inizializzata. I membri possono essere richiamati senza creare un'istanza della classe.

Spazio dei nomi: Sys

Eredita: Sys.Component, Sys.IContainer

Sys.Application.addComponent(componentVar);

Costruttori

Name	Descrizione
Costruttore Sys.Application	Inizializza una nuova istanza della classe Sys.Application.

Membri

Name	Descrizione
Evento Sys.Application.init	Generato dopo il caricamento di tutti gli script ma prima della creazione di oggetti.
Evento Sys.Application.load	Generato dopo il caricamento di tutti gli script e dopo la creazione e l'inizializzazione degli oggetti nell'applicazione.
Evento Sys.Application.navigate	Si verifica quando l'utente sceglie il pulsante Indietro o Avanti del browser.
Evento Sys.Application.unload	Generato prima che tutti gli oggetti nell'applicazione client siano eliminati.
Metodo Sys.Application.addComponent	Registra un componente con l'applicazione e lo inizializza se il componente non è già inizializzato.
Metodo Sys.Application.addHistoryPoint	Crea un punto chiave di navigazione e lo aggiunge allo stack della cronologia del browser.
Metodo Sys.Application.beginCreateComponents	Indica all'applicazione di iniziare la creazione di componenti.
Metodo Sys.Application.beginUpdate	Chiamato dal metodo Sys.Application.beginUpdate per indicare che il processo di impostazione delle proprietà dei componenti dell'applicazione è iniziato.
Metodo Sys.Application.dispose	Rilascia risorse e dipendenze utilizzate dall'applicazione client.
Metodo Sys.Application.endCreateComponents	Indica all'applicazione di terminare la creazione di componenti.
Metodo Sys.Application.endUpdate	Chiamato dal metodo Sys.Application.endCreateComponents per indicare che il processo di aggiornamento dell'applicazione è stato completato.
Metodo Sys.Application.findComponent	Restituisce l'oggetto Sys.Component specificato.
Metodo $find di Sys.Application	Fornisce un collegamento al metodo findComponent.
Metodo Sys.Application.getComponents	Restituisce una matrice di tutti i componenti che sono stati registrati con l'applicazione tramite il metodo addComponent.
Metodo Sys.Application.initialize	Inizializza l'applicazione e genera l'evento load.
Metodo Sys.Application.notifyScriptLoaded	Chiamato da uno script a cui si fa riferimento per indicare che lo script è stato caricato.
Metodo Sys.Application.queueScriptReference	In sequenza mette in coda gli script da caricare nell'ordine in coda.
Metodo Sys.Application.raiseLoad	Genera l'evento load.
Metodo Sys.Application.raisePropertyChanged	Genera l'evento Sys.INotifyPropertyChange.propertyChanged.
Metodo Sys.Application.registerDisposableObject	Registra un oggetto che richiederà l'eliminazione con l'applicazione.
Metodo Sys.Application.removeComponent	Rimuove l'oggetto dall'applicazione e lo elimina se è disposable.
Metodo Sys.Application.unregisterDisposableObject	Annulla la registrazione di un oggetto eliminabile dall'applicazione.
Metodo Sys.Application.updated	Chiamato dal metodo Sys.Application.endUpdate come segnaposto per logica aggiuntiva.
Proprietà Sys.Application.enableHistory	Ottiene o imposta un valore che indica se l'applicazione Web supporta la gestione dei punti chiave di navigazione.
Proprietà Sys.Application.isCreatingComponents	Ottiene un valore che indica se l'applicazione è nel processo di creazione di componenti.

Note

L'oggetto Application fornisce funzioni ed eventi che supportano lo sviluppo di componenti client. L'oggetto Application è una singola istanza della classe Sys._Application privata. L'oggetto Application viene creato quando una pagina AJAX ASP.NET è visualizzata nel browser e persiste per tutta la vita della pagina. L'oggetto Application è responsabile per la generazione di eventi del ciclo di vita della pagina client, ad esempio pageInit, pageLoad e pageUnload e per la gestione dell'eliminazione di componenti registrati.

Eventi

L'oggetto Application fornisce gli eventi init, load e unload ed eredita gli eventi disposing e propertyChanged dalla classe base Component. Tutti questi eventi si applicano al ciclo di vita dell'applicazione client nel browser.

Se il rendering parziale della pagina è supportato e la pagina contiene un controllo UpdatePanel, la classe PageRequestManager fornisce eventi aggiuntivi che si applicano alle parti della pagina sottoposte a rendering in modo asincrono. Per ulteriori informazioni sul rendering a pagina parziale, vedere Cenni preliminari sul rendering a pagina parziale.

I componenti singoli possono esporre eventi che si applicano solo al componente. Possono accedere anche a eventi a livello di applicazione utilizzando l'oggetto Application.

Nella maggior parte dei casi, gli sviluppatori di pagine devono inserire il codice nell'evento load. A quel punto nel ciclo di vita della pagina, tutti gli script sono caricati e tutti i componenti sono stati creati e pronti all'uso. Qualsiasi codice incluso in una funzione denominata pageLoad sarà eseguito automaticamente al caricamento della pagina.

Gli sviluppatori di componenti possono accedere ad altri eventi o associare gestori aggiuntivi agli eventi load o unload richiamando il metodo di accesso add_ dell'evento e passando la funzione di gestione. Nell'esempio riportato di seguito viene mostrato come associare una funzione denominata myUnloadHandler all'evento unload.

Sys.Application.add_unload(myUnloadHandler)

Quando un evento e i relativi gestori non sono più necessari, è possibile chiamare il metodo di accesso remove_, come indicato nell'esempio seguente:

Sys.Application.remove_unload(myUnloadHandler);

È possibile allegare gestori aggiuntivi a un evento richiamando il metodo di accesso add_ una volta per ciascun gestore. I gestori vengono rimossi individualmente chiamando il metodo di accesso remove_.

Per ulteriori informazioni su eventi Sys.Application, vedere Eventi del ciclo di vita del client AJAX.

Aggiunta di componenti

Nella maggior parte degli scenari, è necessario aggiungere componenti a un'applicazione utilizzando il comando $create . Una volta registrato con l'applicazione, è possibile accedere a un componente nell'applicazione chiamando il metodo findComponent o il collegamento $find. È possibile ottenere un elenco di tutti i componenti disponibili chiamando il metodo getComponents.

Per ulteriori informazioni sullo sviluppo di componenti, controlli e comportamenti, vedere Aggiunta di funzionalità AJAX a controlli ASP.NET.

Riferimento a file di script

Se si fa riferimento a un file di script autonomo (file .js) da utilizzare per il rendering a pagina parziale, il codice nel file di script deve chiamare il metodo notifyScriptLoaded. In questo modo viene notificato all'applicazione che lo script ha terminato il caricamento. Per ulteriori informazioni, vedere Metodo Sys.Application.notifyScriptLoaded.

Vedere anche

Riferimenti

Operatore new

Altre risorse

Riferimenti per il linguaggio