Udostępnij za pośrednictwem


ScriptManager.RegisterClientScriptResource Metoda

Definicja

Rejestruje skrypt klienta osadzony w zestawie z ScriptManager kontrolką do użycia z kontrolką, która uczestniczy w renderowaniu częściowym strony.

Przeciążenia

RegisterClientScriptResource(Page, Type, String)

Rejestruje plik skryptu klienta osadzony w zestawie z kontrolką ScriptManager za każdym razem, gdy nastąpi powrót.

RegisterClientScriptResource(Control, Type, String)

Rejestruje skrypt klienta osadzony w zestawie z kontrolką do użycia z ScriptManager kontrolką, która uczestniczy w renderowaniu częściowym strony.

RegisterClientScriptResource(Page, Type, String)

Rejestruje plik skryptu klienta osadzony w zestawie z kontrolką ScriptManager za każdym razem, gdy nastąpi powrót.

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)

Parametry

page
Page

Obiekt strony, który rejestruje skrypt.

type
Type

Typ skryptu klienta. Ten parametr jest zwykle określany przy użyciu operatora typeof (C#) lub operatora GetType (Visual Basic), aby pobrać typ kontrolki rejestrującej skrypt.

resourceName
String

Identyfikator zasobu.

Wyjątki

Zasób type klienta to null.

-lub- Strona rejestrującą skrypt to null.

Uwagi

Po zarejestrowaniu pliku skryptu przy użyciu tej metody skrypt jest renderowany za każdym razem, gdy wystąpi asynchroniczne ponoć. Aby zarejestrować skrypt dla kontrolki, która znajduje się wewnątrz UpdatePanel kontrolki, tak aby skrypt został zarejestrowany tylko po UpdatePanel zaktualizowaniu kontrolki, użyj RegisterClientScriptResource(Control, Type, String) przeciążenia tej metody.

Jeśli chcesz zarejestrować blok skryptu, który nie dotyczy aktualizacji częściowych stron, a jeśli chcesz zarejestrować blok skryptu tylko raz podczas renderowania początkowego ClientScriptManager strony, użyj RegisterClientScriptBlock metody klasy . Odwołanie do ClientScriptManager obiektu można uzyskać z ClientScript właściwości strony.

Zobacz też

Dotyczy

RegisterClientScriptResource(Control, Type, String)

Rejestruje skrypt klienta osadzony w zestawie z kontrolką do użycia z ScriptManager kontrolką, która uczestniczy w renderowaniu częściowym strony.

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)

Parametry

control
Control

Kontrolka, która rejestruje skrypt.

type
Type

Typ skryptu klienta. Ten parametr jest zwykle określany przy użyciu operatora typeof (C#) lub operatora GetType (Visual Basic), aby pobrać typ kontrolki rejestrującej skrypt.

resourceName
String

Identyfikator zasobu.

Wyjątki

Zasób type klienta to null.

-lub- Kontrolka rejestrującą skrypt to null.

Kontrolka, która rejestruje skrypt, nie znajduje się w drzewie sterowania strony.

Uwagi

Metoda służy RegisterClientScriptResource do rejestrowania skryptu zgodnego z renderowaniem częściowym strony i nie ma zależności biblioteki Microsoft Ajax. Zasoby skryptu zarejestrowane przy użyciu tej metody są rejestrowane tylko wtedy, gdy control reprezentuje kontrolkę, która znajduje się wewnątrz zaktualizowanej UpdatePanel kontrolki. Aby zarejestrować skrypt za każdym razem, gdy następuje asynchroniczne wycofywanie, użyj RegisterStartupScript(Page, Type, String, String, Boolean) przeciążenia tej metody.

Jeśli chcesz zarejestrować blok skryptu, który nie dotyczy aktualizacji częściowych stron, a jeśli chcesz zarejestrować blok skryptu tylko raz podczas renderowania początkowego ClientScriptManager strony, użyj RegisterClientScriptBlock metody klasy . Odwołanie do ClientScriptManager obiektu można uzyskać z ClientScript właściwości strony.

Metoda RegisterClientScriptResource jest używana, gdy zasoby z zestawów są dostępne za pośrednictwem procedury obsługi HTTP. Ta metoda zawiera zawartość adresu URL zasobu w elemecie script .

Zarówno metoda, jak RegisterClientScriptInclude i RegisterClientScriptResource metoda ładują pliki skryptów do przeglądarki. Jeśli skrypt o tym samym typie i kluczu (dla pliku skryptu) lub ten sam typ i nazwa zasobu (dla zasobu osadzonego) jest już załadowany, skrypt nie zostanie ponownie załadowany.

Zobacz też

Dotyczy