ScriptManager.RegisterStartupScript Metod

Definition

Namnområde:
System.Web.UI
Sammansättning:
System.Web.Extensions.dll

Registrerar ett startskriptblock med ScriptManager kontrollen och lägger till skriptblocket på sidan.

Överlagringar

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

Registrerar ett startskriptblock för en kontroll som finns inuti en UpdatePanel med hjälp ScriptManager av kontrollen och lägger till skriptblocket på sidan.
RegisterStartupScript(Page, Type, String, String, Boolean)

Registrerar ett startskriptblock för varje asynkron postback med ScriptManager kontrollen och lägger till skriptblocket på sidan.

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

Registrerar ett startskriptblock för en kontroll som finns inuti en UpdatePanel med hjälp ScriptManager av kontrollen och lägger till skriptblocket på sidan.

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)

Parametrar

control
Control

Kontrollen som registrerar klientskriptblocket.

type
Type

Typen av klientskriptblock. Den här parametern anges vanligtvis med hjälp av typ av operator (C#) eller GetType-operatorn (Visual Basic) för att hämta typen av kontroll som registrerar skriptet.

key
String

En unik identifierare för skriptblocket.

script
String

Skriptet som ska registreras.

addScriptTags
Boolean

trueom du vill omsluta skriptblocket med <script> och </script> taggar, annars . false

Undantag

ArgumentNullException

control är null.

-eller-

type är null.

ArgumentException

control finns inte i sidans kontrollträd.

Kommentarer

Du använder metoden RegisterStartupScript för att registrera ett startskriptblock för en sida som är kompatibel med delvis sidåtergivning och som inte har några Microsoft Beroenden för Ajax-bibliotek. Block för startskript som registreras med den här metoden skickas endast till sidan när kontrollen som registrerar blocket finns i en UpdatePanel kontroll som uppdateras. Om du vill registrera ett block för startskript varje gång en asynkron postback inträffar använder du överlagringen av den RegisterStartupScript(Page, Type, String, String, Boolean) här metoden.

Om du vill registrera ett startskript som inte gäller partiella siduppdateringar, och om du bara vill registrera skriptet en gång under den första sidåtergivningen RegisterStartupScript , använder du -metoden för ClientScriptManager klassen. Du kan hämta en referens till ClientScriptManager objektet från ClientScript sidans egenskap.

Skriptblocket som återges av RegisterStartupScript metoden körs när sidan har lästs in men innan sidans klienthändelse onload aktiveras. Block för startskript finns längst ned på den renderade ASP.NET sidan precis före taggen </form>.

Block för startskript som registreras med hjälp RegisterStartupScript av är inte garanterade utdata i samma ordning som de registreras. Om ordningen på startskriptblocken är viktig använder du ett StringBuilder -objekt för att samla in skriptblocken i en enda sträng och registrerar dem sedan som ett enda startskript.

Se även

Gäller för

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

Registrerar ett startskriptblock för varje asynkron postback med ScriptManager kontrollen och lägger till skriptblocket på sidan.

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)

Parametrar

page
Page

Det sidobjekt som registrerar klientskriptblocket.

type
Type

Typen av klientskriptblock. Den här parametern anges vanligtvis med hjälp av typ av operator (C#) eller GetType-operatorn (Visual Basic) för att hämta typen av kontroll som registrerar skriptet.

key
String

En unik identifierare för skriptblocket.

script
String

Skriptet som ska registreras.

addScriptTags
Boolean

trueom du vill omsluta skriptblocket med <script> och </script> taggar, annars . false

Kommentarer

Du använder den här metoden för att registrera ett block för startskript som ingår varje gång en asynkron postback inträffar. Om du vill registrera ett skriptblock för en kontroll som finns i en UpdatePanel kontroll så att skriptblocket endast registreras när UpdatePanel kontrollen uppdateras använder du överbelastningen av den RegisterStartupScript(Control, Type, String, String, Boolean) här metoden.

Om du vill registrera ett startskript som inte gäller partiella siduppdateringar, och om du bara vill registrera skriptet en gång under den första sidåtergivningen RegisterStartupScript , använder du -metoden för ClientScriptManager klassen. Du kan hämta en referens till ClientScriptManager objektet från ClientScript sidans egenskap.

Se även

Gäller för