ScriptManager.RegisterClientScriptResource 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 lo script client incorporato in un assembly con il ScriptManager controllo da usare con un controllo che partecipa al rendering di pagine parziali.
Overload
| Nome | Descrizione |
|---|---|
| RegisterClientScriptResource(Page, Type, String) |
Registra un file di script client incorporato in un assembly con il ScriptManager controllo ogni volta che si verifica un postback. |
| RegisterClientScriptResource(Control, Type, String) |
Registra lo script client incorporato in un assembly con il ScriptManager controllo da usare con un controllo che partecipa al rendering parziale della pagina. |
RegisterClientScriptResource(Page, Type, String)
Registra un file di script client incorporato in un assembly con il ScriptManager controllo ogni volta che si verifica un postback.
public:
static void RegisterClientScriptResource(System::Web::UI::Page ^ page, Type ^ type, System::String ^ resourceName);
public static void RegisterClientScriptResource(System.Web.UI.Page page, Type type, string resourceName);
static member RegisterClientScriptResource : System.Web.UI.Page * Type * string -> unit
Public Shared Sub RegisterClientScriptResource (page As Page, type As Type, resourceName As String)
Parametri
- page
- Page
Oggetto pagina che registra lo script.
- type
- Type
Tipo dello script client. Questo parametro viene in genere specificato usando l'operatore typeof (C#) o l'operatore GetType (Visual Basic) per recuperare il tipo del controllo che sta registrando lo script.
- resourceName
- String
Identificatore della risorsa.
Eccezioni
La risorsa type client è null.
oppure
La pagina che registra lo script è null.
Commenti
Quando si registra un file di script con questo metodo, viene eseguito il rendering dello script ogni volta che si verifica un postback asincrono. Per registrare uno script per un controllo all'interno di un UpdatePanel controllo in modo che lo script venga registrato solo quando il UpdatePanel controllo viene aggiornato, utilizzare l'overload RegisterClientScriptResource(Control, Type, String) di questo metodo.
Se si desidera registrare un blocco di script che non riguarda gli aggiornamenti a pagina parziale e se si desidera registrare il blocco di script una sola volta durante il rendering iniziale della pagina, usare il RegisterClientScriptBlock metodo della ClientScriptManager classe . È possibile ottenere un riferimento all'oggetto ClientScriptManager dalla ClientScript proprietà della pagina.
Vedi anche
Si applica a
RegisterClientScriptResource(Control, Type, String)
Registra lo script client incorporato in un assembly con il ScriptManager controllo da usare con un controllo che partecipa al rendering parziale della pagina.
public:
static void RegisterClientScriptResource(System::Web::UI::Control ^ control, Type ^ type, System::String ^ resourceName);
public static void RegisterClientScriptResource(System.Web.UI.Control control, Type type, string resourceName);
static member RegisterClientScriptResource : System.Web.UI.Control * Type * string -> unit
Public Shared Sub RegisterClientScriptResource (control As Control, type As Type, resourceName As String)
Parametri
- control
- Control
Controllo che registra lo script.
- type
- Type
Tipo dello script client. Questo parametro viene in genere specificato usando l'operatore typeof (C#) o l'operatore GetType (Visual Basic) per recuperare il tipo del controllo che sta registrando lo script.
- resourceName
- String
Identificatore della risorsa.
Eccezioni
La risorsa type client è null.
oppure
Il controllo che registra lo script è null.
Il controllo che registra lo script non si trova nell'albero dei controlli della pagina.
Commenti
Usare il RegisterClientScriptResource metodo per registrare uno script compatibile con il rendering di pagine parziali e che non ha dipendenze di Microsoft Ajax Library. Le risorse script registrate tramite questo metodo vengono registrate solo quando control rappresenta un controllo che si trova all'interno di un UpdatePanel controllo aggiornato. Per registrare uno script ogni volta che si verifica un postback asincrono, usare l'overload RegisterStartupScript(Page, Type, String, String, Boolean) di questo metodo.
Se si desidera registrare un blocco di script che non riguarda gli aggiornamenti a pagina parziale e se si desidera registrare il blocco di script una sola volta durante il rendering iniziale della pagina, usare il RegisterClientScriptBlock metodo della ClientScriptManager classe . È possibile ottenere un riferimento all'oggetto ClientScriptManager dalla ClientScript proprietà della pagina.
Il RegisterClientScriptResource metodo viene usato quando si accede alle risorse dagli assembly tramite un gestore HTTP. Questo metodo include il contenuto dell'URL della risorsa in un script elemento .
Sia il RegisterClientScriptInclude metodo che il RegisterClientScriptResource metodo caricano i file di script nel browser. Se uno script con lo stesso tipo e la stessa chiave (per un file di script) o lo stesso tipo e lo stesso nome di risorsa (per una risorsa incorporata) sono già caricati, lo script non viene ricaricato.