Freigeben über

ScriptManager.RegisterStartupScript Methode

Definition

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

Registriert einen Startskriptblock mit dem ScriptManager Steuerelement und fügt den Skriptblock der Seite hinzu.

Überlädt

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

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

Registriert einen Startskriptblock für jeden asynchronen Postback mit dem ScriptManager Steuerelement und fügt den Skriptblock zur Seite hinzu.

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

Registriert einen Startskriptblock für ein Steuerelement, das sich in einem UpdatePanelScriptManager Steuerelement befindet, 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 in der Regel mit dem Typeof-Operator (C#) oder dem GetType-Operator (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 mit <script> und </script> Tags 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 teilweisem Seitenrendering kompatibel ist und keine Abhängigkeiten der Microsoft Ajax-Bibliothek aufweist. Startskriptblöcke, die mithilfe dieser Methode registriert werden, werden nur dann an die Seite gesendet, wenn sich das Steuerelement, das den Block registriert, in einem UpdatePanel Steuerelement befindet, das aktualisiert wird. Wenn Sie bei jedem Auftreten eines asynchronen Postbacks einen Startskriptblock registrieren möchten, verwenden Sie die RegisterStartupScript(Page, Type, String, String, Boolean) Überladung dieser Methode.

Wenn Sie ein Startskript registrieren möchten, das sich nicht auf Teilseitenaktualisierungen 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 aus der 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 mit der Verwendung RegisterStartupScript registriert sind, 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.

Weitere Informationen

Gilt für:

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

Registriert einen Startskriptblock für jeden asynchronen Postback mit dem ScriptManager Steuerelement und fügt den Skriptblock zur 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 in der Regel mit dem Typeof-Operator (C#) oder dem GetType-Operator (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 mit <script> und </script> Tags einzuschließen; andernfalls false.

Hinweise

Mit dieser Methode registrieren Sie einen Startskriptblock, der bei jedem Auftreten eines asynchronen Postbacks enthalten ist. 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 Teilseitenaktualisierungen 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 aus der ClientScript Eigenschaft der Seite abrufen.

Weitere Informationen

Gilt für: