ScriptManager.RegisterClientScriptResource Metoda

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.Extensions.dll

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

ArgumentNullException

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ż

• RegisterClientScriptResource(Control, Type, String)
• WebResourceAttribute

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

ArgumentNullException

Zasób type klienta to null.

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

ArgumentException

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ż

• RegisterClientScriptResource(Page, Type, String)
• WebResourceAttribute