ScriptManager.RegisterClientScriptResource Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zaregistruje klientský skript vložený do sestavení s ScriptManager ovládacím prvek pro použití s ovládacím prvek, který se účastní částečného vykreslování stránky.
Přetížení
| Name | Description |
|---|---|
| RegisterClientScriptResource(Page, Type, String) |
Zaregistruje soubor klientského skriptu, který je vložen do sestavení, s ovládacím ScriptManager prvku při každém výskytu zpětného odeslání. |
| RegisterClientScriptResource(Control, Type, String) |
Zaregistruje klientský skript vložený do sestavení pomocí ScriptManager ovládacího prvku pro použití s ovládacím prvku, který se účastní částečného vykreslování stránky. |
RegisterClientScriptResource(Page, Type, String)
Zaregistruje soubor klientského skriptu, který je vložen do sestavení, s ovládacím ScriptManager prvku při každém výskytu zpětného odeslání.
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
Objekt stránky, který registruje skript.
- type
- Type
Typ klientského skriptu. Tento parametr je obvykle určen pomocí operátoru typeof (C#) nebo GetType (Visual Basic) k načtení typu ovládacího prvku, který registruje skript.
- resourceName
- String
Identifikátor prostředku.
Výjimky
Prostředek klienta type je null.
nebo
Stránka, která skript registruje, je null.
Poznámky
Při registraci souboru skriptu pomocí této metody se skript vykreslí při každém výskytu asynchronního postbacku. Chcete-li zaregistrovat skript pro ovládací prvek, který je uvnitř UpdatePanel ovládacího prvku, aby byl skript registrován pouze při UpdatePanel aktualizaci ovládacího prvku, použijte RegisterClientScriptResource(Control, Type, String) přetížení této metody.
Pokud chcete zaregistrovat blok skriptu, který se netýká částečných aktualizací stránky, a pokud chcete zaregistrovat blok skriptu pouze jednou během počátečního vykreslování stránky, použijte RegisterClientScriptBlock metodu ClientScriptManager třídy. Odkaz na ClientScriptManager objekt můžete získat z ClientScript vlastnosti stránky.
Viz také
Platí pro
RegisterClientScriptResource(Control, Type, String)
Zaregistruje klientský skript vložený do sestavení pomocí ScriptManager ovládacího prvku pro použití s ovládacím prvku, který se účastní částečného vykreslování stránky.
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
Ovládací prvek, který registruje skript.
- type
- Type
Typ klientského skriptu. Tento parametr je obvykle určen pomocí operátoru typeof (C#) nebo GetType (Visual Basic) k načtení typu ovládacího prvku, který registruje skript.
- resourceName
- String
Identifikátor prostředku.
Výjimky
Prostředek klienta type je null.
nebo
Ovládací prvek, který registruje skript, je null.
Ovládací prvek, který skript registruje, není ve stromu ovládacího prvku stránky.
Poznámky
Tuto metodu RegisterClientScriptResource použijete k registraci skriptu, který je kompatibilní s částečným vykreslováním stránek a který nemá žádné závislosti knihovny Microsoft Ajax Library. Prostředky skriptu, které jsou registrovány pomocí této metody jsou registrovány pouze v případě control , že představuje ovládací prvek, který je uvnitř UpdatePanel ovládacího prvku, který je aktualizován. K registraci skriptu při každém výskytu asynchronního postbacku použijte RegisterStartupScript(Page, Type, String, String, Boolean) přetížení této metody.
Pokud chcete zaregistrovat blok skriptu, který se netýká částečných aktualizací stránky, a pokud chcete zaregistrovat blok skriptu pouze jednou během počátečního vykreslování stránky, použijte RegisterClientScriptBlock metodu ClientScriptManager třídy. Odkaz na ClientScriptManager objekt můžete získat z ClientScript vlastnosti stránky.
Metoda RegisterClientScriptResource se používá při přístupu k prostředkům ze sestavení prostřednictvím obslužné rutiny HTTP. Tato metoda zahrnuje obsah adresy URL prostředku v elementu script .
RegisterClientScriptInclude Soubory skriptu i RegisterClientScriptResource metody načítají do prohlížeče. Pokud je již načten skript se stejným typem a klíčem (pro soubor skriptu) nebo stejný typ a název prostředku (pro vložený prostředek), skript se znovu nenačte.