Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe ScriptManager

 

Data di pubblicazione: aprile 2016

Gestisce librerie di script e file di script, il rendering parziale della pagina e la generazione della classe proxy client per servizi Web e applicativi ASP.NET Ajax.

Spazio dei nomi:   System.Web.UI
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

System.Object
  System.Web.UI.Control
    System.Web.UI.ScriptManager

public class ScriptManager : Control, IPostBackDataHandler, IPostBackEventHandler

NomeDescrizione
System_CAPS_pubmethodScriptManager()

Inizializza una nuova istanza della classe ScriptManager.

NomeDescrizione
System_CAPS_protpropertyAdapter

Ottiene l'adattatore specifiche del browser per il controllo.(Ereditato da Control.)

System_CAPS_pubpropertyAjaxFrameworkAssembly

Ottiene l'assembly del framework Ajax usato dai componenti della pagina.

System_CAPS_pubpropertyAjaxFrameworkMode

Ottiene o imposta un valore che specifica la modalità con cui gli script client della libreria client Microsoft Ajax verranno inclusi nel client.

System_CAPS_pubpropertyAllowCustomErrorsRedirect

Ottiene o imposta un valore che determina se la sezione degli errori personalizzati del file Web.config viene usata durante un errore in un postback asincrono.

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Ottiene o imposta la directory virtuale relativa all'applicazione di Page o UserControl oggetto che contiene questo controllo.(Ereditato da Control.)

System_CAPS_pubpropertyAsyncPostBackErrorMessage

Ottiene o imposta il messaggio di errore inviato al client quando si verifica un'eccezione non gestita del server durante un postback asincrono.

System_CAPS_pubpropertyAsyncPostBackSourceElementID

Ottiene l'ID univoco del controllo che ha provocato il postback asincrono.

System_CAPS_pubpropertyAsyncPostBackTimeout

Ottiene o imposta un valore che indica il tempo, in secondi, prima del timeout dei postback asincroni in assenza di risposte.

System_CAPS_pubpropertyAuthenticationService

Ottiene l'oggetto AuthenticationServiceManager associato all'istanza di ScriptManager corrente.

System_CAPS_pubpropertyBindingContainer

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Ottiene il controllo che contiene l'associazione di dati del controllo.(Ereditato da Control.)

System_CAPS_protpropertyChildControlsCreated

Ottiene un valore che indica se sono stati creati i controlli figlio del controllo server.(Ereditato da Control.)

System_CAPS_pubpropertyClientID

Ottiene l'ID di controllo per il markup HTML generato da ASP.NET.(Ereditato da Control.)

System_CAPS_pubpropertyClientIDMode

Ottiene o imposta l'algoritmo utilizzato per generare il valore di ClientID proprietà.(Ereditato da Control.)

System_CAPS_protpropertyClientIDSeparator

Ottiene un valore di carattere che rappresenta il separatore utilizzato nella ClientID proprietà.(Ereditato da Control.)

System_CAPS_pubpropertyClientNavigateHandler

Ottiene o imposta il nome del metodo che gestisce l’evento Sys.Application.navigate nel client.

System_CAPS_pubpropertyCompositeScript

Ottiene un riferimento allo script composito che supporta la pagina Web.

System_CAPS_protpropertyContext

Ottiene il HttpContext oggetto associato al controllo server per la richiesta Web corrente.(Ereditato da Control.)

System_CAPS_pubpropertyControls

Ottiene un oggetto ControlCollection che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente.(Ereditato da Control.)

System_CAPS_pubpropertyDataItemContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer.(Ereditato da Control.)

System_CAPS_pubpropertyDataKeysContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl.(Ereditato da Control.)

System_CAPS_protpropertyDesignMode

Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione.(Ereditato da Control.)

System_CAPS_pubpropertyEmptyPageUrl

Ottiene o imposta un URL su una pagina Web vuota.

System_CAPS_pubpropertyEnableCdn

Determina se la pagina corrente carica i riferimenti agli script client dai percorsi di rete per la distribuzione di contenuti (CDN).

System_CAPS_pubpropertyEnableCdnFallback

Abilita il caricamento della copia locale di uno script nel caso in cui la rete per la distribuzione di contenuti (CDN) non sia disponibile.

System_CAPS_pubpropertyEnableHistory

Ottiene o imposta un valore che indica se la pagina Web supporta la gestione dei punti chiave di navigazione.

System_CAPS_pubpropertyEnablePageMethods

Ottiene o imposta un valore che indica se i metodi di pagina statici pubblici in una pagina ASP.NET possono essere chiamati da script client.

System_CAPS_pubpropertyEnablePartialRendering

Ottiene o imposta un valore che attiva il rendering parziale di una pagina, che consente a sua volta di aggiornare aree individuali della pagina usando i controlli UpdatePanel.

System_CAPS_pubpropertyEnableScriptGlobalization

Ottiene o imposta un valore che indica se il controllo ScriptManager esegue il rendering dello script che supporta l'analisi e la formattazione di informazioni specifiche delle impostazioni cultura.

System_CAPS_pubpropertyEnableScriptLocalization

Ottiene o imposta un valore che indica se il controllo ScriptManager esegue il rendering delle versioni localizzate dei file di script.

System_CAPS_pubpropertyEnableSecureHistoryState

Ottiene o imposta un valore che indica se crittografare la stringa dello stato della cronologia.

System_CAPS_pubpropertyEnableTheming

Ottiene o imposta un valore che indica se i temi si applicano a questo controllo.(Ereditato da Control.)

System_CAPS_pubpropertyEnableViewState

Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente.(Ereditato da Control.)

System_CAPS_protpropertyEvents

Ottiene un elenco di delegati del gestore eventi per il controllo. Questa proprietà è di sola lettura.(Ereditato da Control.)

System_CAPS_protpropertyHasChildViewState

Ottiene un valore che indica se i controlli figlio del controllo server corrente le impostazioni dello stato di visualizzazione salvate.(Ereditato da Control.)

System_CAPS_pubpropertyID

Ottiene o imposta l'identificatore a livello di codice assegnato al controllo del server.(Ereditato da Control.)

System_CAPS_protpropertyIdSeparator

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Ottiene il carattere utilizzato per separare gli identificatori di controllo.(Ereditato da Control.)

System_CAPS_protpropertyIsChildControlStateCleared

Ottiene un valore che indica se i controlli contenuti all'interno di questo controllo lo stato del controllo.(Ereditato da Control.)

System_CAPS_pubpropertyIsDebuggingEnabled

Ottiene un valore che indica se verrà eseguito il rendering delle versioni di debug delle librerie di script client.

System_CAPS_pubpropertyIsInAsyncPostBack

Ottiene un valore che indica se il postback corrente viene eseguito in modalità di rendering parziale.

System_CAPS_pubpropertyIsNavigating

Ottiene un valore che indica se un evento Navigate è attualmente in corso di elaborazione.

System_CAPS_protpropertyIsTrackingViewState

Ottiene un valore che indica se il controllo del server Salva le modifiche apportate al relativo stato di visualizzazione.(Ereditato da Control.)

System_CAPS_protpropertyIsViewStateEnabled

Ottiene un valore che indica se lo stato di visualizzazione è abilitato per questo controllo.(Ereditato da Control.)

System_CAPS_pubpropertyLoadScriptsBeforeUI

Ottiene o imposta un valore che indica se gli script vengono caricati prima o dopo il caricamento del markup dell'interfaccia utente della pagina.

System_CAPS_protpropertyLoadViewStateByID

Ottiene un valore che indica se il controllo fa parte di caricamento del proprio stato di visualizzazione da ID invece di indice.(Ereditato da Control.)

System_CAPS_pubpropertyNamingContainer

Ottiene un riferimento al controllo del server dei nomi del contenitore, che consente di creare uno spazio dei nomi univoco per distinguere i controlli server con lo stesso Control.ID valore della proprietà.(Ereditato da Control.)

System_CAPS_pubpropertyPage

Ottiene un riferimento di Page istanza che contiene il controllo del server.(Ereditato da Control.)

System_CAPS_pubpropertyParent

Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina.(Ereditato da Control.)

System_CAPS_pubpropertyProfileService

Ottiene l'oggetto ProfileServiceManager associato all'istanza di ScriptManager corrente.

System_CAPS_pubpropertyRenderingCompatibility

Ottiene un valore che specifica la versione ASP.NET che viene eseguito il rendering HTML sarà compatibile con.(Ereditato da Control.)

System_CAPS_pubpropertyRoleService

Ottiene l'oggetto RoleServiceManager associato all'istanza di ScriptManager corrente.

System_CAPS_pubpropertyScriptMode

Ottiene o imposta un valore che specifica se viene eseguito il rendering delle versioni di debug o finali delle librerie di script client.

System_CAPS_pubpropertyScriptPath

Obsoleto. Ottiene o imposta il percorso radice usato per compilare i percorsi dei file ASP.NET Ajax e degli script personalizzati.

System_CAPS_pubpropertySystem_CAPS_staticScriptResourceMapping

Ottiene un oggetto ScriptResourceMapping.

System_CAPS_pubpropertyScripts

Ottiene un oggetto ScriptReferenceCollection che contiene gli oggetti ScriptReference, ciascuno dei quali rappresenta un file di script sottoposto a rendering sul client.

System_CAPS_pubpropertyServices

Ottiene un oggetto ServiceReferenceCollection che contiene un oggetto ServiceReference per ogni servizio Web che ASP.NET espone nel client per la funzionalità Ajax.

System_CAPS_pubpropertySite

Ottiene informazioni sul contenitore che ospita il controllo corrente quando viene eseguito il rendering nell'area di progettazione.(Ereditato da Control.)

System_CAPS_pubpropertySkinID

Ottiene o imposta l'interfaccia personalizzata da applicare al controllo.(Ereditato da Control.)

System_CAPS_pubpropertySupportsPartialRendering

Ottiene un valore che indica se il client supporta il rendering parziale della pagina.

System_CAPS_pubpropertyTemplateControl

Ottiene o imposta un riferimento a un modello che contiene questo controllo.(Ereditato da Control.)

System_CAPS_pubpropertyTemplateSourceDirectory

Ottiene la directory virtuale del Page o UserControl che contiene il controllo del server corrente.(Ereditato da Control.)

System_CAPS_pubpropertyUniqueID

Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server.(Ereditato da Control.)

System_CAPS_pubpropertyValidateRequestMode

Ottiene o imposta un valore che indica se il controllo verifica l'input per il client dal browser per valori potenzialmente pericolosi.(Ereditato da Control.)

System_CAPS_protpropertyViewState

Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un controllo server in più richieste per la stessa pagina.(Ereditato da Control.)

System_CAPS_protpropertyViewStateIgnoresCase

Ottiene un valore che indica se il StateBag oggetto è tra maiuscole e minuscole.(Ereditato da Control.)

System_CAPS_pubpropertyViewStateMode

Ottiene o imposta la modalità di stato di visualizzazione di questo controllo.(Ereditato da Control.)

System_CAPS_pubpropertyVisible

Esegue l'override della proprietà Visible ereditata dalla classe Control di base per impedire l'impostazione di questo valore.(Esegue l'override di Control.Visible.)

NomeDescrizione
System_CAPS_protmethodAddedControl(Control, Int32)

Chiamato dopo l'aggiunta di un controllo figlio per il Controls insieme il Control oggetto.(Ereditato da Control.)

System_CAPS_pubmethodAddHistoryPoint(NameValueCollection, String)

Crea un punto chiave di navigazione e lo aggiunge allo stack della cronologia del browser, usando la raccolta dei dati dello stato specificato e il titolo dello stato.

System_CAPS_pubmethodAddHistoryPoint(String, String)

Crea un punto chiave di navigazione e lo aggiunge allo stack della cronologia del browser, usando la chiave e il valore di stato specificati.

System_CAPS_pubmethodAddHistoryPoint(String, String, String)

Crea un punto chiave di navigazione e lo aggiunge allo stack della cronologia del browser, usando la chiave, il valore e il titolo specificati per lo stato.

System_CAPS_protmethodAddParsedSubObject(Object)

Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto ControlCollection del controllo server.(Ereditato da Control.)

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Applica le proprietà di stile definite nel foglio di stile della pagina al controllo.(Ereditato da Control.)

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Avvia la traccia in fase di progettazione di dati di rendering.(Ereditato da Control.)

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Raccoglie informazioni sul controllo del server e li recapita alla Trace proprietà da visualizzare quando è attivata per la pagina.(Ereditato da Control.)

System_CAPS_protmethodClearCachedClientID()

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Imposta memorizzato nella cache ClientID valore null.(Ereditato da Control.)

System_CAPS_protmethodClearChildControlState()

Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server.(Ereditato da Control.)

System_CAPS_protmethodClearChildState()

Elimina le informazioni sullo stato di visualizzazione e controllo dello stato per tutti i server controlli figlio del controllo.(Ereditato da Control.)

System_CAPS_protmethodClearChildViewState()

Elimina le informazioni sullo stato di visualizzazione per tutti i server controlli figlio del controllo.(Ereditato da Control.)

System_CAPS_protmethodClearEffectiveClientIDMode()

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Imposta il ClientIDMode proprietà dell'istanza del controllo corrente e di eventuali controlli figlio di Inherit.(Ereditato da Control.)

System_CAPS_protmethodCreateChildControls()

Viene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che usano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti in preparazione per il postback o il rendering.(Ereditato da Control.)

System_CAPS_protmethodCreateControlCollection()

Crea un nuovo ControlCollection oggetto per contenere i controlli figlio del controllo del server (valore letterale e server).(Ereditato da Control.)

System_CAPS_pubmethodDataBind()

Associa un'origine dati al controllo server richiamato e a tutti i controlli figlio.(Ereditato da Control.)

System_CAPS_protmethodDataBind(Boolean)

Associa un'origine dati per il controllo server richiamato e tutti i relativi controlli figlio con un'opzione per generare il DataBinding evento.(Ereditato da Control.)

System_CAPS_protmethodDataBindChildren()

Associa un'origine dati ai controlli figlio del controllo server.(Ereditato da Control.)

System_CAPS_pubmethodDispose()

Consente a un controllo server eseguire pulitura finale prima che venga rilasciato dalla memoria.(Ereditato da Control.)

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Termina la traccia in fase di progettazione di dati di rendering.(Ereditato da Control.)

System_CAPS_protmethodEnsureChildControls()

Determina se il controllo del server contiene controlli figlio. In caso contrario, crea dei controlli figlio.(Ereditato da Control.)

System_CAPS_protmethodEnsureID()

Crea un identificatore per i controlli che non dispongono di un identificatore assegnato.(Ereditato da Control.)

System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.(Ereditato da Object.)

System_CAPS_protmethodFinalize()

Consente a un oggetto di effettuare un tentativo di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperato da Garbage Collection.(Ereditato da Object.)

System_CAPS_pubmethodFindControl(String)

Cerca nel contenitore di denominazione corrente per un controllo server con l'oggetto specificato id parametro.(Ereditato da Control.)

System_CAPS_protmethodFindControl(String, Int32)

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Cerca nel contenitore di denominazione corrente per un controllo server con l'oggetto specificato id e un numero intero, specificato nella pathOffset parametro, che agevola la ricerca. Eseguire l'override di questa versione di FindControl metodo.(Ereditato da Control.)

System_CAPS_pubmethodFocus()

Imposta lo stato attivo a un controllo.(Ereditato da Control.)

System_CAPS_pubmethodSystem_CAPS_staticGetCurrent(Page)

Ottiene l'istanza ScriptManager per un oggetto Page specificato.

System_CAPS_protmethodGetDesignModeState()

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Ottiene i dati in fase di progettazione di un controllo.(Ereditato da Control.)

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetRegisteredArrayDeclarations()

Recupera una raccolta di sola lettura delle dichiarazioni di matrice ECMAScript (JavaScript) precedentemente registrate con l'oggetto Page.

System_CAPS_pubmethodGetRegisteredClientScriptBlocks()

Recupera una matrice di sola lettura dei blocchi di script client precedentemente registrati con il controllo ScriptManager.

System_CAPS_pubmethodGetRegisteredDisposeScripts()

Recupera una raccolta di sola lettura degli script dispose precedentemente registrati con l'oggetto Page.

System_CAPS_pubmethodGetRegisteredExpandoAttributes()

Recupera una raccolta di sola lettura degli attributi personalizzati (expando) precedentemente registrati con l'oggetto Page.

System_CAPS_pubmethodGetRegisteredHiddenFields()

Recupera una raccolta di sola lettura dei campi nascosti precedentemente registrati con l'oggetto Page.

System_CAPS_pubmethodGetRegisteredOnSubmitStatements()

Recupera una raccolta di sola lettura delle istruzioni onsubmit precedentemente registrate con l'oggetto Page.

System_CAPS_pubmethodGetRegisteredStartupScripts()

Recupera una raccolta di sola lettura degli script di avvio precedentemente registrati con l'oggetto Page.

System_CAPS_pubmethodGetRouteUrl(Object)

Ottiene l'URL che corrisponde a un set di parametri di route.(Ereditato da Control.)

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Ottiene l'URL che corrisponde a un set di parametri di route.(Ereditato da Control.)

System_CAPS_pubmethodGetRouteUrl(String, Object)

Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route.(Ereditato da Control.)

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route.(Ereditato da Control.)

System_CAPS_pubmethodGetStateString()

Recupera una stringa contenente le coppie nome/valore che rappresentano lo stato di una pagina Web.

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Restituisce la parte del prefissata di UniqueID proprietà del controllo specificato.(Ereditato da Control.)

System_CAPS_pubmethodHasControls()

Determina se il controllo del server contiene eventuali controlli figlio.(Ereditato da Control.)

System_CAPS_protmethodHasEvents()

Restituisce un valore che indica se gli eventi vengono registrati per il controllo o eventuali controlli figlio.(Ereditato da Control.)

System_CAPS_protmethodIsLiteralContent()

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Determina se il controllo server conserva solo contenuto effettivo.(Ereditato da Control.)

System_CAPS_protmethodLoadControlState(Object)

Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente è stato salvato tramite il SaveControlState metodo.(Ereditato da Control.)

System_CAPS_protmethodLoadPostData(String, NameValueCollection)

Legge i dati del form inseriti dal browser al server e determina l'origine del postback asincrono.

System_CAPS_protmethodLoadViewState(Object)

Ripristina le informazioni sullo stato di visualizzazione da una richiesta di pagina precedente è stato salvato tramite il SaveViewState metodo.(Ereditato da Control.)

System_CAPS_protmethodMapPathSecure(String)

Recupera il percorso fisico che esegue il mapping a un percorso virtuale, assoluto o relativo.(Ereditato da Control.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_protmethodOnAsyncPostBackError(AsyncPostBackErrorEventArgs)

Genera l'evento AsyncPostBackError.

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

Determina se l'evento per il controllo server viene passato a un livello superiore nella gerarchia dei controlli server dell'interfaccia utente per la pagina.(Ereditato da Control.)

System_CAPS_protmethodOnDataBinding(EventArgs)

Genera l'evento DataBinding.(Ereditato da Control.)

System_CAPS_protmethodOnInit(EventArgs)

Genera l'evento Init e verifica che esista solo un controllo ScriptManager nella pagina.(Esegue l'override di Control.OnInit(EventArgs).)

System_CAPS_protmethodOnLoad(EventArgs)

Genera l'evento Load.(Ereditato da Control.)

System_CAPS_protmethodOnPreRender(EventArgs)

Genera l'evento PreRender e registra i file di script e i servizi per gli aggiornamenti parziali della pagina.(Esegue l'override di Control.OnPreRender(EventArgs).)

System_CAPS_protmethodOnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)
System_CAPS_protmethodOnResolveScriptReference(ScriptReferenceEventArgs)

Genera l'evento ResolveScriptReference per ogni riferimento a script gestito dal controllo ScriptManager.

System_CAPS_protmethodOnUnload(EventArgs)

Genera l'evento Unload.(Ereditato da Control.)

System_CAPS_protmethodOpenFile(String)

Ottiene un Stream utilizzata per leggere un file.(Ereditato da Control.)

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Assegna eventuali origini dell'evento e le informazioni relative al padre del controllo.(Ereditato da Control.)

System_CAPS_protmethodRaisePostBackEvent(String)

Elabora un evento di postback generato dal controllo ScriptManager e carica lo stato della cronologia della pagina Web.

System_CAPS_protmethodRaisePostDataChangedEvent()

Genera eventi per il controllo ScriptManager durante il postback al server.

System_CAPS_pubmethodSystem_CAPS_staticRegisterArrayDeclaration(Control, String, String)

Registra una dichiarazione di matrice di ECMAScript (JavaScript) con il controllo ScriptManager da usare con un controllo compreso in un controllo UpdatePanel e aggiunge la matrice alla pagina.

System_CAPS_pubmethodSystem_CAPS_staticRegisterArrayDeclaration(Page, String, String)

Registra una dichiarazione di matrice di ECMAScript (JavaScript) con il controllo ScriptManager da usare con un controllo compreso in un controllo UpdatePanel e aggiunge la matrice alla pagina.

System_CAPS_pubmethodRegisterAsyncPostBackControl(Control)

Registra un controllo come trigger per i postback asincroni.

System_CAPS_pubmethodSystem_CAPS_staticRegisterClientScriptBlock(Control, Type, String, String, Boolean)

Registra un blocco di script client con il controllo ScriptManager da usare con un controllo compreso in un controllo UpdatePanel e quindi aggiunge il blocco di script alla pagina.

System_CAPS_pubmethodSystem_CAPS_staticRegisterClientScriptBlock(Page, Type, String, String, Boolean)

Registra un blocco di script client con il controllo ScriptManager da usare con un controllo compreso in un controllo UpdatePanel e quindi aggiunge il blocco di script alla pagina.

System_CAPS_pubmethodSystem_CAPS_staticRegisterClientScriptInclude(Control, Type, String, String)

Registra un file di script client con il controllo ScriptManager da usare con un controllo compreso in un controllo UpdatePanel e quindi aggiunge un riferimento al file di script alla pagina.

System_CAPS_pubmethodSystem_CAPS_staticRegisterClientScriptInclude(Page, Type, String, String)

Registra lo script client con il controllo ScriptManager ogni volta che si verifica un postback asincrono e quindi aggiunge un riferimento al file di script alla pagina.

System_CAPS_pubmethodSystem_CAPS_staticRegisterClientScriptResource(Control, Type, String)

Registra lo script client incorporato in un assembly con il controllo ScriptManager da usare con un controllo che partecipa al rendering parziale della pagina.

System_CAPS_pubmethodSystem_CAPS_staticRegisterClientScriptResource(Page, Type, String)

Registra un file di script client incorporato in un assembly con il controllo ScriptManager ogni volta che si verifica un postback asincrono.

System_CAPS_pubmethodRegisterDataItem(Control, String)

Invia dati personalizzati a un controllo durante il rendering parziale della pagina.

System_CAPS_pubmethodRegisterDataItem(Control, String, Boolean)

Invia dati personalizzati a un controllo durante il rendering parziale della pagina e indica se i dati sono in formato JavaScript Object Notation (JSON).

System_CAPS_pubmethodRegisterDispose(Control, String)

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

System_CAPS_pubmethodSystem_CAPS_staticRegisterExpandoAttribute(Control, String, String, String, Boolean)

Registra una coppia nome/valore con il controllo ScriptManager come attributo personalizzato (expando) di un controllo specificato.

System_CAPS_pubmethodRegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)

Registra un controllo Extender con l'istanza ScriptManager corrente.

System_CAPS_pubmethodSystem_CAPS_staticRegisterHiddenField(Control, String, String)

Registra un campo nascosto con il controllo ScriptManager per un controllo compreso in un controllo UpdatePanel.

System_CAPS_pubmethodSystem_CAPS_staticRegisterHiddenField(Page, String, String)

Registra un campo nascosto con il controllo ScriptManager durante ogni postback asincrono.

System_CAPS_pubmethodSystem_CAPS_staticRegisterNamedClientScriptResource(Control, String)

Registra lo script client incorporato in un assembly con il controllo ScriptManager da usare con un controllo che partecipa al rendering parziale della pagina.

System_CAPS_pubmethodSystem_CAPS_staticRegisterNamedClientScriptResource(Page, String)

Registra lo script client incorporato in un assembly con il controllo ScriptManager da usare con un controllo che partecipa al rendering parziale della pagina.

System_CAPS_pubmethodSystem_CAPS_staticRegisterOnSubmitStatement(Control, Type, String, String)

Registra il codice ECMAScript (JavaScript) con il controllo ScriptManager per un controllo usato con un controllo UpdatePanel eseguito quando il form viene inviato.

System_CAPS_pubmethodSystem_CAPS_staticRegisterOnSubmitStatement(Page, Type, String, String)

Registra il codice ECMAScript (JavaScript) con il controllo ScriptManager per un controllo usato con un controllo UpdatePanel eseguito quando il form viene inviato.

System_CAPS_pubmethodRegisterPostBackControl(Control)

Registra un controllo come trigger per un postback. Questo metodo viene usato per i controlli di postback all'interno di un controllo UpdatePanel che altrimenti eseguirebbe postback asincroni.

System_CAPS_pubmethodRegisterScriptControl<TScriptControl>(TScriptControl)

Registra un controllo Script con l'istanza ScriptManager corrente.

System_CAPS_pubmethodRegisterScriptDescriptors(IExtenderControl)

Esegue la richiamata a una classe ExtenderControl per restituire gli script dell'istanza di cui eseguire il rendering per supportare l'oggetto client che rappresenta un controllo, un componente o un comportamento client.

System_CAPS_pubmethodRegisterScriptDescriptors(IScriptControl)

Chiama una classe ScriptControl per restituire gli script dell'istanza di cui eseguire il rendering per supportare l'oggetto client che rappresenta un controllo, un componente o un comportamento client.

System_CAPS_pubmethodSystem_CAPS_staticRegisterStartupScript(Control, Type, String, String, Boolean)

Registra un blocco di script di avvio per un controllo compreso in un controllo UpdatePanel usando il controllo ScriptManager e aggiunge il blocco di script alla pagina.

System_CAPS_pubmethodSystem_CAPS_staticRegisterStartupScript(Page, Type, String, String, Boolean)

Registra un blocco di script di avvio per ogni postback asincrono con il controllo ScriptManager e aggiunge il blocco di script alla pagina.

System_CAPS_protmethodRemovedControl(Control)

Chiamato dopo la rimozione di un controllo figlio dal Controls insieme il Control oggetto.(Ereditato da Control.)

System_CAPS_protmethodRender(HtmlTextWriter)

Esegue il rendering del contenuto del controllo ScriptManager nel browser usando l'oggetto HtmlTextWriter specificato.(Esegue l'override di Control.Render(HtmlTextWriter).)

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Restituisce il contenuto di elementi figlio di un controllo server a un oggetto fornito HtmlTextWriter oggetto, che scrive il contenuto da sottoporre a rendering sul client.(Ereditato da Control.)

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Restituisce il contenuto del controllo a un oggetto fornito HtmlTextWriter dell'oggetto e vengono archiviate le informazioni sul controllo se è attivata.(Ereditato da Control.)

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Restituisce il contenuto del controllo a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter oggetto.(Ereditato da Control.)

System_CAPS_protmethodResolveAdapter()

Ottiene l'adattatore di controllo è responsabile per il rendering del controllo specificato.(Ereditato da Control.)

System_CAPS_pubmethodResolveClientUrl(String)

Ottiene un URL che può essere utilizzato dal browser.(Ereditato da Control.)

System_CAPS_pubmethodResolveUrl(String)

Converte un URL in un formato utilizzabile dal client richiedente.(Ereditato da Control.)

System_CAPS_protmethodSaveControlState()

Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server.(Ereditato da Control.)

System_CAPS_protmethodSaveViewState()

Salva eventuali modifiche dello stato di visualizzazione di un controllo server apportate dopo il postback della pagina nel server.(Ereditato da Control.)

System_CAPS_protmethodSetDesignModeState(IDictionary)

Imposta i dati della fase di progettazione per un controllo.(Ereditato da Control.)

System_CAPS_pubmethodSetFocus(Control)

Imposta lo stato attivo del browser sul controllo specificato.

System_CAPS_pubmethodSetFocus(String)

Imposta lo stato attivo del browser sul controllo specificato dall'ID.

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e il relativo contenuto nel relativo controllo padre.(Ereditato da Control.)

System_CAPS_pubmethodSetTraceData(Object, Object)

Set di dati per analisi dei dati di rendering, utilizzando la chiave di dati di traccia e il valore di dati di traccia di in fase di progettazione di traccia.(Ereditato da Control.)

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Set di dati per analisi dei dati di rendering, utilizzando l'oggetto tracciato, la chiave di dati di traccia e il valore di dati di traccia di in fase di progettazione di traccia.(Ereditato da Control.)

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta l'oggetto corrente.(Ereditato da Object.)

System_CAPS_protmethodTrackViewState()

Fa sì che il rilevamento delle modifiche dello stato di visualizzazione per il controllo del server in modo che possano essere archiviate nel controllo del server StateBag oggetto. È possibile accedere a questo oggetto tramite la proprietà Control.ViewState.(Ereditato da Control.)

NomeDescrizione
System_CAPS_pubeventAsyncPostBackError

Si verifica in presenza di un errore della pagina durante un postback asincrono.

System_CAPS_pubeventDataBinding

Si verifica quando il controllo server viene associato a un'origine dati.(Ereditato da Control.)

System_CAPS_pubeventDisposed

Si verifica quando un controllo server viene rilasciato dalla memoria, ovvero l'ultima fase del ciclo di vita di controllo server quando viene richiesta una pagina ASP.NET.(Ereditato da Control.)

System_CAPS_pubeventInit

Si verifica quando viene inizializzato il controllo del server, ovvero il primo passaggio nel ciclo di vita.(Ereditato da Control.)

System_CAPS_pubeventLoad

Si verifica quando il controllo server viene caricato il Page oggetto.(Ereditato da Control.)

System_CAPS_pubeventNavigate

Si verifica quando l'utente sceglie il pulsante Indietro o Avanti del browser.

System_CAPS_pubeventPreRender

Si verifica dopo il Control oggetto viene caricato, ma prima del rendering.(Ereditato da Control.)

System_CAPS_pubeventResolveCompositeScriptReference

Si verifica quando uno script composito viene registrato con il controllo ScriptManager.

System_CAPS_pubeventResolveScriptReference

Si verifica quando un membro della raccolta Scripts viene registrato con il controllo ScriptManager.

System_CAPS_pubeventUnload

Si verifica quando il controllo server viene scaricato dalla memoria.(Ereditato da Control.)

NomeDescrizione
System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Per una descrizione di questo membro, vedere IControlDesignerAccessor.GetDesignModeState.(Ereditato da Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Per una descrizione di questo membro, vedere IControlDesignerAccessor.SetDesignModeState.(Ereditato da Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Per una descrizione di questo membro, vedere IControlDesignerAccessor.SetOwnerControl.(Ereditato da Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Per una descrizione di questo membro, vedere IParserAccessor.AddParsedSubObject.(Ereditato da Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackDataHandler.LoadPostData(String, NameValueCollection)

Per una descrizione di questo membro, vedere IPostBackDataHandler.LoadPostData.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackDataHandler.RaisePostDataChangedEvent()

Per una descrizione di questo membro, vedere IPostBackDataHandler.RaisePostDataChangedEvent.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackEventHandler.RaisePostBackEvent(String)

Abilita il controllo ScriptManager per elaborare un evento postback e caricare lo stato della cronologia della pagina Web.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Per una descrizione di questo membro, vedere IControlBuilderAccessor.ControlBuilder.(Ereditato da Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Per una descrizione di questo membro, vedere IControlDesignerAccessor.UserData.(Ereditato da Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Per una descrizione di questo membro, vedere IDataBindingsAccessor.DataBindings.(Ereditato da Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Per una descrizione di questo membro, vedere IDataBindingsAccessor.HasDataBindings.(Ereditato da Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Per una descrizione di questo membro, vedere IExpressionsAccessor.Expressions.(Ereditato da Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Per una descrizione di questo membro, vedere IExpressionsAccessor.HasExpressions.(Ereditato da Control.)

NomeDescrizione
System_CAPS_pubmethodFindDataSourceControl()

Restituisce l'origine dati che è associato al controllo di dati per il controllo specificato.(Definito da DynamicDataExtensions.)

System_CAPS_pubmethodFindFieldTemplate(String)

Restituisce che il modello di campo per la colonna specificata nel controllo specificato del contenitore di denominazione.(Definito da DynamicDataExtensions.)

System_CAPS_pubmethodFindMetaTable()

Restituisce l'oggetto metatabella per il controllo dati contenitore.(Definito da DynamicDataExtensions.)

Il ScriptManager controllo è fondamentale per la funzionalità Ajax in ASP.NET. Il controllo gestisce tutte le risorse in una pagina ASP.NET Ajax. Questo implica il download libreria Microsoft Ajax gli script per il browser e il coordinamento degli aggiornamenti a pagina parziale che vengono attivati tramite UpdatePanel controlli. Inoltre, il ScriptManager controllo consente di eseguire le operazioni seguenti:

  • Registrare script compatibili con gli aggiornamenti a pagina parziale. Per gestire le dipendenze tra gli script e la libreria di base, qualsiasi script registrato viene caricato dopo il libreria Microsoft Ajax script.

  • Specificare se rilasciare o degli script di debug vengono inviati al browser.

  • Fornire accesso ai metodi del servizio Web dallo script registrando i servizi Web con il ScriptManager controllo.

  • Fornire l'accesso all'autenticazione, ruoli e profilo ASP.NET servizi delle applicazioni da script client tramite la registrazione di questi servizi con il ScriptManager controllo.

  • Abilitare la visualizzazione delle impostazioni cultura specifiche di ECMAScript (JavaScript) e funzioni nel browser.

  • Accedere alle risorse di localizzazione per i file di script incorporati o autonomi utilizzando il ResourceUICultures di proprietà di ScriptReference controllo.

  • Registrare i controlli server che implementano il IExtenderControl o IScriptControl interagisce con il ScriptManager controllare in modo che viene eseguito il rendering degli script richiesti per i componenti client e i comportamenti.

La possibilità di una pagina ASP.NET per il supporto per il rendering a pagina parziale è controllata dai fattori seguenti:

È possibile sostituire il valore di EnablePartialRendering proprietà in fase di esecuzione durante o prima della pagina Init evento. Se si tenta di modificare questa proprietà dopo la pagina Init si è verificato un evento, un InvalidOperationException viene generata un'eccezione.

Quando il rendering a pagina parziale è supportato, il ScriptManager controllo esegue il rendering dello script per abilitare i postback asincroni e aggiornamenti a pagina parziale. Le aree della pagina da aggiornare vengono definite utilizzando UpdatePanel controlli. Il ScriptManager controllo gestisce i postback asincroni e aggiorna solo le aree della pagina che devono essere aggiornate. Per ulteriori informazioni sul rendering parziale della pagina, vedere Partial-Page Rendering Overview. Per ulteriori informazioni sulle condizioni che provocano un aggiornamento, vedere UpdatePanel Control Overview.

Una pagina può contenere un solo ScriptManager controllo nella relativa gerarchia. Per registrare gli script per pagine annidate, controlli utente o i componenti e servizi quando la pagina padre dispone già di un ScriptManager di controllo, utilizzare il ScriptManagerProxy controllo. Per altre informazioni, vedere Using the ASP.NET UpdatePanel Control with Master Pages.

Il ScriptManager controllo consente di registrare uno script che viene quindi eseguito il rendering come parte della pagina. Il ScriptManager metodi di controllo di registrazione possono essere suddiviso in tre categorie seguenti:

  • I metodi di registrazione che garantiscono che le dipendenze dello script per il libreria Microsoft Ajax vengono mantenute.

  • I metodi di registrazione che non siano presenti il libreria Microsoft Ajax, ma che sono compatibili con UpdatePanel controlli.

  • I metodi di registrazione che supportano l'utilizzo con UpdatePanel controlli.

Per ulteriori informazioni su come creare e usare script Ajax in ASP.NET, vedere Creating Custom Client Script by Using the Microsoft Ajax Library.

È possibile utilizzare i metodi seguenti per registrare i file di script in modo che mantengano le dipendenze nel libreria Microsoft Ajax vengono mantenute. 

Metodo

Definizione

RegisterScriptControl<TScriptControl>

Registra un controllo server che implementa il IScriptControl interfaccia utilizzata per definire un oggetto client. Il ScriptManager controllo esegue il rendering dello script che supporta l'oggetto client.

RegisterExtenderControl<TExtenderControl>

Registra un controllo server che implementa il IExtenderControl interfaccia utilizzata per definire un oggetto client. Il ScriptManager controllo esegue il rendering dello script che supporta l'oggetto client.

È possibile utilizzare i metodi seguenti per registrare i file di script che non siano presenti il libreria Microsoft Ajax ma che sono compatibili con UpdatePanel controlli. Questi metodi corrispondono ai metodi simili del ClientScriptManager controllo. Se si è il rendering di script per l'utilizzo all'interno di un UpdatePanel di controllo, assicurarsi di chiamare i metodi del ScriptManager controllo.

Metodo

Definizione

RegisterArrayDeclaration

Aggiunge un valore a una matrice JavaScript. Se la matrice non esiste, viene creato.

RegisterClientScriptBlock

Esegue il rendering di un script elemento dopo l'apertura della pagina <form> tag. Lo script viene specificato come parametro di stringa.

RegisterClientScriptInclude

Esegue il rendering di un script elemento dopo l'apertura della pagina <form> tag. Il contenuto dello script viene specificato impostando il src attributo a un URL che punta a un file di script.

RegisterClientScriptResource

Esegue il rendering di un script elemento dopo l'apertura della pagina <form> tag. Il contenuto dello script viene specificato con un nome di risorsa in un assembly. Il src attributo viene popolato automaticamente con un URL da una chiamata a un gestore HTTP che recupera lo script denominato dall'assembly.

RegisterExpandoAttribute

Esegue il rendering di una coppia nome/valore personalizzato (expando) nel markup per un controllo specificato.

RegisterHiddenField

Esegue il rendering di un campo nascosto.

RegisterOnSubmitStatement

Registra uno script che viene eseguito in risposta al form dell'elemento submit evento. Il onSubmit attributo fa riferimento lo script specificato.

RegisterStartupScript

Esegue il rendering di un blocco di script di avvio prima parentesi di chiusura della pagina </form> tag. Lo script per eseguire il rendering è specificato come parametro di stringa.

Quando si registrano i metodi, si specifica una coppia chiave/tipo per lo script. Se uno script con la stessa coppia chiave/tipo è già registrato, non è registrato un nuovo script. Analogamente, se si registra uno script con una coppia di nome tipo/risorsa che già esiste, il script elemento che fa riferimento alla risorsa non viene aggiunto nuovamente. Quando si registra un attributo expando di un attributo registrato in precedenza, viene generata un'eccezione. Registrazione duplicata di valori della matrice è consentita.

Quando si chiama il RegisterClientScriptInclude o RegisterClientScriptResource (metodo), evitare di registrare script che eseguono funzioni inline. Al contrario, registrare uno script che contiene le definizioni di funzione come gestori eventi o definizioni di classe personalizzate per l'applicazione.

È possibile utilizzare i metodi seguenti per personalizzare gli aggiornamenti a pagina parziale quando si utilizza UpdatePanel controlli.

Metodo

Definizione

RegisterAsyncPostBackControl

Registra un controllo come trigger per i postback asincroni.

RegisterDataItem

Invia dati personalizzati ai controlli durante il rendering parziale della pagina.

RegisterDispose

Registra uno script dispose per un controllo all'interno di un UpdatePanel controllo. Lo script viene eseguito quando il controllo UpdatePanel viene aggiornato o eliminato. Il metodo dispose viene utilizzato per i componenti client che fanno parte della libreria Microsoft Ajax e che è necessario liberare risorse quando un componente non viene più utilizzato.

RegisterPostBackControl

Registra un controllo come trigger per un postback completo. Questo metodo viene utilizzato per i controlli all'interno di un UpdatePanel controllo che altrimenti eseguirebbe postback asincroni.

È possibile registrare un servizio Web per essere chiamati da script client creando un ServiceReference oggetto e aggiungerlo al Services insieme il ScriptManager controllo. ASP.NET genera un oggetto proxy client per ogni ServiceReference oggetto di Services insieme. È possibile aggiungere a livello di programmazione ServiceReference oggetti per il Services insieme per registrare i servizi Web in fase di esecuzione.

Per ulteriori informazioni su come accedere ai servizi Web negli script, vedere Exposing Web Services to Client Script in ASP.NET AJAX e Calling Web Services from Client Script in ASP.NET AJAX.

Il ScriptManager controllo genera riferimenti nella pagina sottoposta a rendering che puntano ai file di script localizzati appropriati sono file script incorporati in assembly o file script autonomi.

Quando il EnableScriptLocalization è impostata su true, ScriptManager controllo recupera le risorse localizzate (ad esempio stringhe localizzate) per la lingua corrente, se presenti. Il ScriptManager controllo offre le seguenti funzionalità per l'utilizzo di risorse localizzate:

  • File incorporati in un assembly di script. Il ScriptManager controllo determina quali file di script specifiche delle impostazioni cultura o impostazioni cultura di fallback da inviare al browser. Esegue questa operazione utilizzando le impostazioni cultura specifiche NeutralResourcesLanguageAttribute attributo dell'assembly, le risorse incluse con l'assembly e le impostazioni cultura dell'interfaccia utente del browser (se presente).

  • File script autonomi. Il ScriptManager controllo definisce l'elenco delle impostazioni cultura dell'interfaccia utente che sono supportati tramite la ResourceUICultures proprietà del ScriptReference oggetto.

  • In modalità di debug. Il ScriptManager controllo tenta di eseguire il rendering di un file di script specifiche delle impostazioni cultura che contiene le informazioni di debug. Ad esempio, se la pagina è in modalità di debug e le impostazioni cultura correnti è impostata su en-MX, il controllo esegue il rendering di un file di script con un nome, ad esempio scriptname. en-MX, se il file esiste. Se il file non esiste, viene eseguito il rendering di file di debug per la lingua di fallback appropriata

Per ulteriori informazioni su come localizzare le risorse, vedere Localizing Resources for Component Libraries Overview.

Quando si verifica un errore di pagina durante i postback asincroni, il AsyncPostBackError viene generato l'evento. Il modo in cui gli errori nel server vengono inviati al client dipende il AllowCustomErrorsRedirect proprietà, il AsyncPostBackErrorMessage proprietà e la sezione degli errori personalizzati del file Web. config. Per altre informazioni, vedere Customizing Error Handling for ASP.NET UpdatePanel Controls.

<asp:ScriptManager
    AllowCustomErrorsRedirect="True|False"
    AsyncPostBackErrorMessage="string"
    AsyncPostBackTimeout="integer"
    AuthenticationService-Path="uri"
    EnablePageMethods="True|False"
    EnablePartialRendering="True|False"
    EnableScriptGlobalization="True|False"
    EnableScriptLocalization="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    LoadScriptsBeforeUI="True|False"
    OnAsyncPostBackError="AsyncPostBackError event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnResolveScriptReference="ResolveScriptReference event handler"
    OnUnload="Unload event handler"
    ProfileService-LoadProperties="string"
    ProfileService-Path="uri"
    RoleService-LoadRoles="True|False"
    RoleService-Path="uri"
    runat="server"
    ScriptMode="Auto|Inherit|Debug|Release"
    ScriptPath="string"
    SkinID="string"
    SupportsPartialRendering="True|False"
    Visible="True|False"
>
        <AuthenticationService
            Path="uri"
        />
        <ProfileService
            LoadProperties="string"
            Path="uri"
        />
        <RoleService
            LoadRoles="True|False"
            Path="uri"
        />
        <Scripts>
            <asp:ScriptReference
                Assembly="string"
                IgnoreScriptPath="True|False"
                Name="string"
                NotifyScriptLoaded="True|False"
                Path="string"
                ResourceUICultures="string"
                ScriptMode="Auto|Debug|Inherit|Release"
            />
        </Scripts>
        <Services>
            <asp:ServiceReference
                InlineScript="True|False"
                Path="string"
            />
        </Services>
</asp:ScriptManager>

Gli esempi seguenti illustrano diversi scenari per l'utilizzo di ScriptManager controllo.

Abilitazione degli aggiornamenti a pagina parziale

Nell'esempio seguente viene illustrato come utilizzare il ScriptManager controllo per abilitare gli aggiornamenti a pagina parziale. In questo esempio, un Calendar e DropDownList controllo sono all'interno di un UpdatePanel controllo. Per impostazione predefinita, il valore della UpdateMode proprietà Always, e il valore del ChildrenAsTriggers è true. Di conseguenza, i controlli figlio del pannello provocano un postback asincrono.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    void DropDownSelection_Change(Object sender, EventArgs e)
    {
        Calendar1.DayStyle.BackColor =
            System.Drawing.Color.FromName(ColorList.SelectedItem.Value);
    }

    protected void Calendar1_SelectionChanged(object sender, EventArgs e)
    {
        SelectedDate.Text = 
            Calendar1.SelectedDate.ToString();
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
                               runat="server" />
            <asp:UpdatePanel ID="UpdatePanel1"
                             runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" 
                                  ShowTitle="True"
                                  OnSelectionChanged="Calendar1_SelectionChanged"
                                  runat="server" />
                    <div>
                        Background:
                        <br />
                        <asp:DropDownList ID="ColorList" 
                                          AutoPostBack="True" 
                                          OnSelectedIndexChanged="DropDownSelection_Change"
                                          runat="server">
                            <asp:ListItem Selected="True" Value="White"> 
                            White </asp:ListItem>
                            <asp:ListItem Value="Silver"> 
                            Silver </asp:ListItem>
                            <asp:ListItem Value="DarkGray"> 
                            Dark Gray </asp:ListItem>
                            <asp:ListItem Value="Khaki"> 
                            Khaki </asp:ListItem>
                            <asp:ListItem Value="DarkKhaki"> D
                            ark Khaki </asp:ListItem>
                        </asp:DropDownList>
                    </div>
                    <br />
                    Selected date:
                    <asp:Label ID="SelectedDate" 
                               runat="server">None.</asp:Label>
                </ContentTemplate>
            </asp:UpdatePanel>
            <br />
        </div>
    </form>
</body>
</html>

Gestione degli errori di aggiornamento a pagina parziale e registrazione di Script

Nell'esempio seguente viene illustrato come fornire la gestione durante gli aggiornamenti a pagina parziale errori personalizzata. Per impostazione predefinita, quando si verifica un errore durante l'aggiornamento a pagina parziale, viene visualizzata una finestra di messaggio JavaScript. In questo esempio viene illustrato come utilizzare la gestione, fornendo un gestore di errori personalizzata di AsyncPostBackError eventi e impostando il AsyncPostBackErrorMessage proprietà nel gestore eventi. È inoltre possibile impostare il AllowCustomErrorsRedirect proprietà per specificare come viene utilizzata la sezione degli errori personalizzati del file Web. config quando si verifica un errore durante gli aggiornamenti a pagina parziale. In questo esempio, il valore predefinito di AllowCustomErrorsRedirect proprietà viene utilizzata. Ciò significa che, se il file Web. config contiene un elemento, tale elemento determina la modalità di visualizzazione degli errori. Per ulteriori informazioni, vedere customErrors Element (ASP.NET Settings Schema).

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Button1_Click(object sender, EventArgs e)
    {
        try
        {
            int a = Int32.Parse(TextBox1.Text);
            int b = Int32.Parse(TextBox2.Text);
            int res = a / b;
            Label1.Text = res.ToString();
        }
        catch (Exception ex)
        {
            if (TextBox1.Text.Length > 0 && TextBox2.Text.Length > 0)
            {
                ex.Data["ExtraInfo"] = " You can't divide " +
                    TextBox1.Text + " by " + TextBox2.Text + ".";
            }
            throw ex;
        }
    }

    protected void ScriptManager1_AsyncPostBackError(object sender, AsyncPostBackErrorEventArgs e)
    {
        if (e.Exception.Data["ExtraInfo"] != null)
        {
            ScriptManager1.AsyncPostBackErrorMessage =
                e.Exception.Message +
                e.Exception.Data["ExtraInfo"].ToString();
        }
        else
        {
            ScriptManager1.AsyncPostBackErrorMessage =
                "An unspecified error occurred.";
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Error Handling Example</title>
    <style type="text/css">
    #UpdatePanel1 {
      width: 200px; height: 50px;
      border: solid 1px gray;
    }
    #AlertDiv{
    left: 40%; top: 40%;
    position: absolute; width: 200px;
    padding: 12px; 
    border: #000000 1px solid;
    background-color: white; 
    text-align: left;
    visibility: hidden;
    z-index: 99;
    }
    #AlertButtons{
    position: absolute; right: 5%; bottom: 5%;
    }
    </style>
</head>
<body id="bodytag">
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
            OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
            <Scripts>
            <asp:ScriptReference Path="ErrorHandling.js" />
            </Scripts>
            </asp:ScriptManager>
            <asp:UpdatePanel ID="UpdatePanel1" runat="server">
                <ContentTemplate>
                    <asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
                    /
                    <asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
                    =
                    <asp:Label ID="Label1" runat="server"></asp:Label><br />
                    <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
                </ContentTemplate>
            </asp:UpdatePanel>
            <div id="AlertDiv">
                <div id="AlertMessage">
                </div>
                <br />
                <div id="AlertButtons">
                    <input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
                </div>
            </div>
        </div>
    </form>
</body>
</html>

Globalizzazione della data e ora in cui vengono visualizzati nel Browser

Nell'esempio seguente viene illustrato come impostare la EnableScriptGlobalization proprietà in modo che lo script client può visualizzare specifiche delle impostazioni cultura data e ora nel browser. Nell'esempio di Culture attributo della direttiva è impostato su auto. Di conseguenza, la prima lingua specificata nelle impostazioni del browser corrente determina le impostazioni cultura e le impostazioni cultura dell'interfaccia utente per la pagina. Per altre informazioni, vedere Procedura: impostare le impostazioni cultura e le impostazioni cultura dell'interfaccia utente per la globalizzazione della pagina Web ASP.NET.

<%@ Page Language="C#" Culture="auto" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>Globalization Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
        </asp:ScriptManager>
        <script type="text/javascript">
        function pageLoad() {
          Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
        }
        function formatDate() {
          var d = new Date();
          try {
            $get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
          }
          catch(e) {
            alert("Error:" + e.message);
          }
        }
        </script>
        <asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
        <ContentTemplate>
        <asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
        <asp:Button ID="Button1" runat="server" Text="Display Date" />

        <br />

        <asp:Label ID="Label1" runat="server"></asp:Label>
        </asp:Panel>
        </ContentTemplate>
        </asp:UpdatePanel>
    </form>
</body>
</html>

.NET Framework
Disponibile da 3.5

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: