ScriptManager.RegisterClientScriptResource Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.Extensions.dll

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

Overload

RegisterClientScriptResource(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.
RegisterClientScriptResource(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.

RegisterClientScriptResource(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.

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 per la risorsa.

Eccezioni

ArgumentNullException

La risorsa client type è null.

-oppure-

La pagina che registra lo script è null.

Commenti

Quando si registra un file di script con questo metodo, il rendering dello script viene eseguito ogni volta che si verifica un postback asincrono. Per registrare uno script per un controllo che si trova in un controllo UpdatePanel in modo che lo script venga registrato solo quando il controllo UpdatePanel viene aggiornato, usare l'overload RegisterClientScriptResource(Control, Type, String) di questo metodo.

Se si vuole registrare un blocco di script che non riguarda gli aggiornamenti parziali della pagina e si vuole registrare il blocco di script solo una volta durante il rendering della pagina iniziale, usare il metodo RegisterClientScriptBlock della classe ClientScriptManager. È possibile ottenere un riferimento all'oggetto ClientScriptManager dalla proprietà ClientScript della pagina.

Vedi anche

Si applica a

RegisterClientScriptResource(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.

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 per la risorsa.

Eccezioni

ArgumentNullException

La risorsa client type è null.

-oppure-

Il controllo che registra lo script è null.

ArgumentException

Il controllo che registra lo script non è presente nella struttura ad albero dei controlli della pagina.

Commenti

Usare il RegisterClientScriptResource metodo per registrare uno script compatibile con il rendering a pagina parziale e che non ha dipendenze della libreria Ajax Microsoft. 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 vuole registrare un blocco di script che non riguarda gli aggiornamenti parziali della pagina e si vuole registrare il blocco di script solo una volta durante il rendering della pagina iniziale, usare il metodo RegisterClientScriptBlock della classe ClientScriptManager. È possibile ottenere un riferimento all'oggetto ClientScriptManager dalla proprietà ClientScript 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) è già caricato, lo script non viene ricaricato.

Vedi anche

Si applica a