Condividi tramite


ScriptManager.RegisterClientScriptResource Metodo

Definizione

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.

Vedi anche

Si applica a