ScriptManager.RegisterStartupScript Metoda

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.Extensions.dll

Rejestruje blok skryptu uruchamiania za pomocą kontrolki ScriptManager i dodaje blok skryptu do strony.

Przeciążenia

RegisterStartupScript(Control, Type, String, String, Boolean)	Rejestruje blok skryptu uruchamiania dla kontrolki, która znajduje się wewnątrz UpdatePanel kontrolki przy użyciu kontrolki ScriptManager , i dodaje blok skryptu do strony.
RegisterStartupScript(Page, Type, String, String, Boolean)	Rejestruje blok skryptu uruchamiania dla każdego asynchronicznego wycofywania za pomocą kontrolki ScriptManager i dodaje blok skryptu do strony.

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

Rejestruje blok skryptu uruchamiania dla kontrolki, która znajduje się wewnątrz UpdatePanel kontrolki przy użyciu kontrolki ScriptManager , i dodaje blok skryptu do strony.

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

Kontrolka rejestrującą blok skryptu klienta.

type

Type

Typ bloku skryptu klienta. Ten parametr jest zwykle określany przy użyciu operatora typeof (C#) lub operatora GetType (Visual Basic), aby pobrać typ kontrolki, która rejestruje skrypt.

key

String

Unikatowy identyfikator bloku skryptu.

script

String

Skrypt do zarejestrowania.

addScriptTags

Boolean

true aby ująć blok skryptu za pomocą tagów <script> i </script> ; w przeciwnym razie false.

Wyjątki

ArgumentNullException

control to null.

-lub-

type to null.

ArgumentException

control nie znajduje się w drzewie sterowania strony.

Uwagi

Metoda służy RegisterStartupScript do rejestrowania bloku skryptu uruchamiania dla strony zgodnej z renderowaniem częściowej strony i nie ma Microsoft zależności biblioteki Ajax. Bloki skryptu uruchamiania zarejestrowane przy użyciu tej metody są wysyłane do strony tylko wtedy, gdy kontrolka rejestrującą blok znajduje się wewnątrz aktualizowanej UpdatePanel kontrolki. Aby zarejestrować blok skryptu uruchamiania za każdym razem, gdy wystąpi asynchroniczny postback, użyj RegisterStartupScript(Page, Type, String, String, Boolean) przeciążenia tej metody.

Jeśli chcesz zarejestrować skrypt uruchamiania, który nie dotyczy aktualizacji częściowych stron, a jeśli chcesz zarejestrować skrypt tylko raz podczas początkowego ClientScriptManager renderowania strony, użyj RegisterStartupScript metody klasy . Odwołanie do ClientScriptManager obiektu można uzyskać z ClientScript właściwości strony.

Blok skryptu renderowany przez metodę jest wykonywany po zakończeniu RegisterStartupScript ładowania strony, ale przed podniesieniem zdarzenia klienta onload strony. Bloki skryptów uruchamiania znajdują się w dolnej części renderowanej strony ASP.NET tuż przed tagiem </form> .

Bloki skryptu uruchamiania zarejestrowane przy użyciu RegisterStartupScript nie mają gwarancji, że dane wyjściowe będą wyświetlane w tej samej kolejności, w której są zarejestrowane. Jeśli kolejność bloków skryptu uruchamiania jest ważna, użyj StringBuilder obiektu, aby zebrać bloki skryptów w jednym ciągu, a następnie zarejestrować je wszystkie jako pojedynczy skrypt uruchamiania.

Zobacz też

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

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

Rejestruje blok skryptu uruchamiania dla każdego asynchronicznego wycofywania za pomocą kontrolki ScriptManager i dodaje blok skryptu do strony.

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

Obiekt strony rejestrujący blok skryptu klienta.

type

Type

Typ bloku skryptu klienta. Ten parametr jest zwykle określany przy użyciu operatora typeof (C#) lub operatora GetType (Visual Basic), aby pobrać typ kontrolki, która rejestruje skrypt.

key

String

Unikatowy identyfikator bloku skryptu.

script

String

Skrypt do zarejestrowania.

addScriptTags

Boolean

true aby ująć blok skryptu za pomocą tagów <script> i </script> ; w przeciwnym razie false.

Uwagi

Ta metoda służy do rejestrowania bloku skryptu uruchamiania, który jest uwzględniany za każdym razem, gdy wystąpi asynchroniczne wycofanie. Aby zarejestrować blok skryptu dla kontrolki, która znajduje się wewnątrz UpdatePanel kontrolki, aby blok skryptu był zarejestrowany tylko po UpdatePanel zaktualizowaniu kontrolki, użyj RegisterStartupScript(Control, Type, String, String, Boolean) przeciążenia tej metody.

Jeśli chcesz zarejestrować skrypt uruchamiania, który nie dotyczy aktualizacji częściowych stron, a jeśli chcesz zarejestrować skrypt tylko raz podczas początkowego ClientScriptManager renderowania strony, użyj RegisterStartupScript metody klasy . Odwołanie do ClientScriptManager obiektu można uzyskać z ClientScript właściwości strony.

Zobacz też

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