ScriptManager.RegisterStartupScript Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.Extensions.dll

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

Přetížení

RegisterStartupScript(Control, Type, String, String, Boolean)	Zaregistruje blok spouštěcího skriptu pro ovládací prvek, který je uvnitř objektu UpdatePanel pomocí ScriptManager 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í zpětné odeslání 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ř objektu UpdatePanel pomocí ScriptManager 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

true k uzavření bloku skriptu se značkami <script> a , </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

Použijete metodu RegisterStartupScript k registraci bloku spouštěcího skriptu pro stránku, která je kompatibilní s vykreslováním částečné stránky a která nemá žádné závislosti Microsoft Ajax Library. Bloky spouštěcího skriptu, které jsou registrovány pomocí této metody, jsou odeslány na stránku pouze v případě, že ovládací prvek, který tento blok registruje, je uvnitř UpdatePanel ovládacího prvku, který se aktualizuje. Chcete-li zaregistrovat blok spouštěcího skriptu pokaždé, když dojde k asynchronnímu postback, 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 stránkových aktualizací, a chcete-li zaregistrovat skript pouze jednou během počátečního vykreslování stránky, použijte metodu RegisterStartupScriptClientScriptManager 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é stránky ASP.NET těsně před značkou </form> .

Bloky spouštěcích skriptů zaregistrované pomocí RegisterStartupScript nemají zaručeno, ž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é, použijte StringBuilder objekt ke shromáždění bloků skriptu v jednom řetězci a pak je všechny 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í zpětné odeslání 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

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

Poznámky

Tuto metodu použijete k registraci bloku spouštěcího skriptu, který je zahrnut pokaždé, když dojde k asynchronnímu zpětnému odeslání. Chcete-li zaregistrovat blok skriptu pro ovládací prvek, který je uvnitř UpdatePanel ovládacího prvku tak, aby blok skriptu byl 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 stránkových aktualizací, a chcete-li zaregistrovat skript pouze jednou během počátečního vykreslování stránky, použijte metodu RegisterStartupScriptClientScriptManager třídy . Odkaz na ClientScriptManager objekt můžete získat z ClientScript vlastnosti stránky.

Viz také

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