ScriptManager.RegisterStartupScript Methode

  • Referenz

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.Extensions.dll

Registriert einen Startskriptblock beim ScriptManager-Steuerelement und fügt den Skriptblock der Seite hinzu.

Überlädt

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

Registriert einen Startskriptblock für ein Steuerelement, das sich in einem UpdatePanel-Steuerelement befindet, mithilfe des ScriptManager-Steuerelements, und fügt den Skriptblock der Seite hinzu.
RegisterStartupScript(Page, Type, String, String, Boolean)

Registriert einen Startskriptblock für jedes asynchrone Postback beim ScriptManager-Steuerelement und fügt den Skriptblock der Seite hinzu.

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

Registriert einen Startskriptblock für ein Steuerelement, das sich in einem UpdatePanel-Steuerelement befindet, mithilfe des ScriptManager-Steuerelements, und fügt den Skriptblock der Seite hinzu.

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)

Parameter

control
Control

Das Steuerelement, das den Clientskriptblock registriert.

type
Type

Der Typ des Clientskriptblocks. Dieser Parameter wird meist mithilfe des Operators "typeof" (C#) bzw. des Operators "GetType" (Visual Basic) angegeben, um den Typ des Steuerelements abzurufen, das das Skript registriert.

key
String

Ein eindeutiger Bezeichner für den Skriptblock.

script
String

Das zu registrierende Skript.

addScriptTags
Boolean

true, um den Skriptblock in die Tags <script> und </script> einzuschließen, andernfalls false.

Ausnahmen

ArgumentNullException

control ist null.

- oder - type ist null.

ArgumentException

control befindet sich nicht in der Steuerelementstruktur der Seite.

Hinweise

Sie verwenden die RegisterStartupScript Methode, um einen Startskriptblock für eine Seite zu registrieren, die mit teilseitigem Rendern kompatibel ist und keine Abhängigkeiten von Microsoft Ajax Library aufweist. Startskriptblöcke, die mithilfe dieser Methode registriert werden, werden nur dann an die Seite gesendet, wenn das Steuerelement, das den Block registriert, innerhalb eines UpdatePanel Steuerelements befindet, das aktualisiert wird. Verwenden Sie die RegisterStartupScript(Page, Type, String, String, Boolean) Überladung dieser Methode, um einen Startskriptblock jedes Mal zu registrieren, wenn ein asynchroner Postback auftritt.

Wenn Sie ein Startskript registrieren möchten, das sich nicht auf Teilseitenupdates bezieht, und wenn Sie das Skript nur einmal während des ersten Seitenrenderings registrieren möchten, verwenden Sie die RegisterStartupScript Methode der ClientScriptManager Klasse. Sie können einen Verweis auf das ClientScriptManager Objekt über die ClientScript Eigenschaft der Seite abrufen.

Der Skriptblock, der von der RegisterStartupScript Methode gerendert wird, wird ausgeführt, wenn das Laden der Seite abgeschlossen ist, aber bevor das Clientereignis onload der Seite ausgelöst wird. Startskriptblöcke befinden sich am unteren Rand der gerenderten ASP.NET Seite direkt vor dem </form> Tag.

Startskriptblöcke, die mithilfe der Verwendung RegisterStartupScript registriert werden, sind nicht garantiert, dass sie in derselben Reihenfolge ausgegeben werden, in der sie registriert sind. Wenn die Reihenfolge der Startskriptblöcke wichtig ist, verwenden Sie ein StringBuilder Objekt, um die Skriptblöcke in einer einzelnen Zeichenfolge zu sammeln und dann alle als einzelnes Startskript zu registrieren.

Siehe auch

Gilt für

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

Registriert einen Startskriptblock für jedes asynchrone Postback beim ScriptManager-Steuerelement und fügt den Skriptblock der Seite hinzu.

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)

Parameter

page
Page

Das Seitenobjekt, das den Clientskriptblock registriert.

type
Type

Der Typ des Clientskriptblocks. Dieser Parameter wird meist mithilfe des Operators "typeof" (C#) bzw. des Operators "GetType" (Visual Basic) angegeben, um den Typ des Steuerelements abzurufen, das das Skript registriert.

key
String

Ein eindeutiger Bezeichner für den Skriptblock.

script
String

Das zu registrierende Skript.

addScriptTags
Boolean

true, um den Skriptblock in die Tags <script> und </script> einzuschließen, andernfalls false.

Hinweise

Sie verwenden diese Methode, um einen Startskriptblock zu registrieren, der jedes Mal enthalten ist, wenn ein asynchroner Postback auftritt. Um einen Skriptblock für ein Steuerelement zu registrieren, das sich innerhalb eines UpdatePanel Steuerelements befindet, damit der Skriptblock nur registriert wird, wenn das UpdatePanel Steuerelement aktualisiert wird, verwenden Sie die RegisterStartupScript(Control, Type, String, String, Boolean) Überladung dieser Methode.

Wenn Sie ein Startskript registrieren möchten, das sich nicht auf Teilseitenupdates bezieht, und wenn Sie das Skript nur einmal während des ersten Seitenrenderings registrieren möchten, verwenden Sie die RegisterStartupScript Methode der ClientScriptManager Klasse. Sie können einen Verweis auf das ClientScriptManager Objekt über die ClientScript Eigenschaft der Seite abrufen.

Siehe auch

Gilt für