Freigeben über

ScriptManager.RegisterOnSubmitStatement Methode

Definition

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

Registriert ECMAScript (JavaScript)-Code, der beim Senden des Formulars ausgeführt wird.

Überlädt

Name Beschreibung
RegisterOnSubmitStatement(Page, Type, String, String)

Registriert ECMAScript -Code (JavaScript) mit dem ScriptManager Steuerelement für ein Steuerelement, das mit einem UpdatePanel Steuerelement verwendet wird, das beim Senden des Formulars ausgeführt wird.
RegisterOnSubmitStatement(Control, Type, String, String)

Registriert ECMAScript -Code (JavaScript) mit dem ScriptManager Steuerelement für ein Steuerelement, das mit einem UpdatePanel Steuerelement verwendet wird, das beim Senden des Formulars ausgeführt wird.

RegisterOnSubmitStatement(Page, Type, String, String)

Registriert ECMAScript -Code (JavaScript) mit dem ScriptManager Steuerelement für ein Steuerelement, das mit einem UpdatePanel Steuerelement verwendet wird, das beim Senden des Formulars ausgeführt wird.

public:
 static void RegisterOnSubmitStatement(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ script);
public static void RegisterOnSubmitStatement(System.Web.UI.Page page, Type type, string key, string script);
static member RegisterOnSubmitStatement : System.Web.UI.Page * Type * string * string -> unit
Public Shared Sub RegisterOnSubmitStatement (page As Page, type As Type, key As String, script As String)

Parameter

page
Page

Das Page-Objekt, das die onsubmit Anweisung registriert.

type
Type

Der Typ der Clientskriptanweisung. 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 die Skriptanweisung.

script
String

Das zu registrierende Skript.

Ausnahmen

ArgumentNullException

page ist null.

- oder -

type ist null.

Hinweise

Durch das Registrieren von JavaScript-Code bei dieser Methode wird das Skript jedes Mal einbezogen, wenn ein asynchroner Postback auftritt.

Hinweis

Code aus früheren asynchronen Postbacks wird nicht entfernt. Neue asynchrone Postbacks fügen Code an jeden vorhandenen Code für die onsubmit Anweisung an.

Um Code für ein Steuerelement zu registrieren, das sich innerhalb eines UpdatePanel Steuerelements befindet, damit der Code nur registriert wird, wenn das UpdatePanel Steuerelement aktualisiert wird, verwenden Sie die RegisterOnSubmitStatement(Control, Type, String, String) Überladung dieser Methode.

Wenn Sie JavaScript-Code registrieren möchten, der nicht zu Teilseitenaktualisierungen gehört, und wenn Sie den Code nur einmal während des anfänglichen Seitenrenderings registrieren möchten, verwenden Sie die RegisterOnSubmitStatement 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:

RegisterOnSubmitStatement(Control, Type, String, String)

Registriert ECMAScript -Code (JavaScript) mit dem ScriptManager Steuerelement für ein Steuerelement, das mit einem UpdatePanel Steuerelement verwendet wird, das beim Senden des Formulars ausgeführt wird.

public:
 static void RegisterOnSubmitStatement(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ script);
public static void RegisterOnSubmitStatement(System.Web.UI.Control control, Type type, string key, string script);
static member RegisterOnSubmitStatement : System.Web.UI.Control * Type * string * string -> unit
Public Shared Sub RegisterOnSubmitStatement (control As Control, type As Type, key As String, script As String)

Parameter

control
Control

Das Steuerelement, das die onsubmit Anweisung registriert.

type
Type

Der Typ der Clientskriptanweisung. 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 die Skriptanweisung.

script
String

Das zu registrierende Skript.

Ausnahmen

ArgumentNullException

control ist null.

- oder -

type ist null.

ArgumentException

control befindet sich nicht in der Steuerelementstruktur der Seite.

Hinweise

Das RegisterOnSubmitStatement hinzugefügte Skript, das vor dem Senden des Formulars ausgeführt wird, sodass Sie die Übermittlung ändern oder abbrechen können.

Sie verwenden die RegisterOnSubmitStatement Methode, um eine onsubmit Anweisung zu rendern, die mit teilweisem Seitenrendering kompatibel ist und keine Abhängigkeiten der Microsoft Ajax-Bibliothek aufweist. JavaScript-Code, der mithilfe dieser Methode registriert wird, wird nur dann an die Seite gesendet, wenn sich das Steuerelement, das die Anweisung registriert, in einem UpdatePanel Steuerelement befindet, das aktualisiert wird. Verwenden Sie die RegisterOnSubmitStatement(Page, Type, String, String) Überladung dieser Methode, um Code bei jedem asynchronen Postback zu registrieren.

Wenn Sie JavaScript-Code registrieren möchten, der nicht zu Teilseitenaktualisierungen gehört, und wenn Sie den Code nur einmal während des anfänglichen Seitenrenderings registrieren möchten, verwenden Sie die RegisterOnSubmitStatement Methode der ClientScriptManager Klasse. Sie können einen Verweis auf das ClientScriptManager Objekt aus der ClientScript Eigenschaft der Seite abrufen.

Der Skriptparameter der RegisterOnSubmitStatement Methode kann mehrere Skriptbefehle enthalten, die durch Semikolons (;)) getrennt sind.

Weitere Informationen zu HTML-Formularen und zum onsubmit Ereignis finden Sie auf der Website des World Wide Web Consortium (W3C).

Weitere Informationen

Gilt für: