ScriptManager.RegisterStartupScript Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.Extensions.dll

Zaregistruje blok spouštěcího skriptu ovládacím ScriptManager prvku a přidá blok skriptu na stránku.

Přetížení

Name	Description
RegisterStartupScript(Control, Type, String, String, Boolean)	Zaregistruje blok spouštěcího skriptu pro ovládací prvek, který je uvnitř UpdatePanelScriptManager ovládacího prvku, a přidá blok skriptu na stránku.
RegisterStartupScript(Page, Type, String, String, Boolean)	Zaregistruje blok spouštěcího skriptu pro každý asynchronní postback pomocí ScriptManager ovládacího prvku a přidá blok skriptu na stránku.

RegisterStartupScript(Control, Type, String, String, Boolean)

Zaregistruje blok spouštěcího skriptu pro ovládací prvek, který je uvnitř UpdatePanelScriptManager ovládacího prvku, a přidá blok skriptu na stránku.

public:
 static void RegisterStartupScript(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);

public static void RegisterStartupScript(System.Web.UI.Control control, Type type, string key, string script, bool addScriptTags);

static member RegisterStartupScript : System.Web.UI.Control * Type * string * string * bool -> unit

Public Shared Sub RegisterStartupScript (control As Control, type As Type, key As String, script As String, addScriptTags As Boolean)

Parametry

control

Control

Ovládací prvek, který registruje blok klientského skriptu.

type

Type

Typ bloku 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.

key

String

Jedinečný identifikátor bloku skriptu.

script

String

Skript, který se má zaregistrovat.

addScriptTags

Boolean

truepro uzavření bloku skriptu se značkami<script>, </script> jinak . false

Výjimky

ArgumentNullException

control je null.

nebo

type je null.

ArgumentException

control není ve stromu ovládacích prvků stránky.

Poznámky

Tuto metodu RegisterStartupScript použijete k registraci bloku spouštěcího skriptu pro stránku, která je kompatibilní s částečným vykreslováním stránek a která nemá žádné závislosti knihovny Microsoft Ajax Library. Bloky spouštěcích skriptů, které jsou registrovány pomocí této metody jsou odeslány na stránku pouze v případě, že ovládací prvek, který registruje blok, je uvnitř UpdatePanel ovládacího prvku, který se aktualizuje. Chcete-li zaregistrovat blok spouštěcího 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 spouštěcí skript, který se netýká částečných aktualizací stránky, a pokud chcete skript zaregistrovat pouze jednou během počátečního vykreslování stránky, použijte RegisterStartupScript metodu ClientScriptManager třídy. Odkaz na ClientScriptManager objekt můžete získat z ClientScript vlastnosti stránky.

Blok skriptu vykreslený metodou RegisterStartupScript se spustí po dokončení načítání stránky, ale před vyvoláním události klienta onload stránky. Bloky spouštěcích skriptů se nacházejí v dolní části vykreslené ASP.NET stránky těsně před značkou </form> .

Bloky spouštěcích skriptů, které jsou zaregistrované pomocí, RegisterStartupScript nejsou zaručeny, že budou výstupem ve stejném pořadí, v jakém jsou registrovány. Pokud je pořadí bloků spouštěcích skriptů důležité, pomocí StringBuilder objektu shromážděte bloky skriptu v jednom řetězci a pak je zaregistrujte jako jeden spouštěcí skript.

Viz také

• RegisterStartupScript(Page, Type, String, String, Boolean)

RegisterStartupScript(Page, Type, String, String, Boolean)

Zaregistruje blok spouštěcího skriptu pro každý asynchronní postback pomocí ScriptManager ovládacího prvku a přidá blok skriptu na stránku.

public:
 static void RegisterStartupScript(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);

public static void RegisterStartupScript(System.Web.UI.Page page, Type type, string key, string script, bool addScriptTags);

static member RegisterStartupScript : System.Web.UI.Page * Type * string * string * bool -> unit

Public Shared Sub RegisterStartupScript (page As Page, type As Type, key As String, script As String, addScriptTags As Boolean)

Parametry

page

Page

Objekt stránky, který registruje blok klientského skriptu.

type

Type

Typ bloku 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.

key

String

Jedinečný identifikátor bloku skriptu.

script

String

Skript, který se má zaregistrovat.

addScriptTags

Boolean

truepro uzavření bloku skriptu se značkami<script>, </script> jinak . false

Poznámky

Tuto metodu použijete k registraci bloku spouštěcího skriptu, který je zahrnut při každém výskytu asynchronního postbacku. Chcete-li zaregistrovat blok skriptu pro ovládací prvek, který je uvnitř UpdatePanel ovládacího prvku, aby byl blok skriptu registrován pouze při UpdatePanel aktualizaci ovládacího prvku, použijte RegisterStartupScript(Control, Type, String, String, Boolean) přetížení této metody.

Pokud chcete zaregistrovat spouštěcí skript, který se netýká částečných aktualizací stránky, a pokud chcete skript zaregistrovat pouze jednou během počátečního vykreslování stránky, použijte RegisterStartupScript metodu ClientScriptManager třídy. Odkaz na ClientScriptManager objekt můžete získat z ClientScript vlastnosti stránky.

Viz také

• RegisterStartupScript(Control, Type, String, String, Boolean)