ScriptManager.RegisterOnSubmitStatement Methode

  • Referenz

Definition

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

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

Überlädt

RegisterOnSubmitStatement(Page, Type, String, String)

Registriert ECMAScript-Code (JavaScript) beim ScriptManager-Steuerelement für ein Steuerelement mit UpdatePanel-Steuerelement mit Ausführung beim Senden des Formulars.
RegisterOnSubmitStatement(Control, Type, String, String)

Registriert ECMAScript-Code (JavaScript) beim ScriptManager-Steuerelement für ein Steuerelement mit UpdatePanel-Steuerelement mit Ausführung beim Senden des Formulars.

RegisterOnSubmitStatement(Page, Type, String, String)

Registriert ECMAScript-Code (JavaScript) beim ScriptManager-Steuerelement für ein Steuerelement mit UpdatePanel-Steuerelement mit Ausführung beim Senden des Formulars.

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 Seitenobjekt, das die onsubmit-Anweisung registriert.

type
Type

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

script
String

Das zu registrierende Skript.

Ausnahmen

ArgumentNullException

page ist null.

- oder - type ist null.

Hinweise

Das Registrieren von JavaScript-Code mit dieser Methode bewirkt, dass das Skript jedes Mal enthalten wird, wenn ein asynchrones Postback auftritt.

Hinweis

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

Um Code für ein Steuerelement zu registrieren, das sich in einem UpdatePanel Steuerelement befindet, sodass 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 sich nicht auf Teilseitenupdates bezieht, 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 Objekt aus der ClientScriptManager ClientScript Eigenschaft der Seite abrufen.

Siehe auch

Gilt für

RegisterOnSubmitStatement(Control, Type, String, String)

Registriert ECMAScript-Code (JavaScript) beim ScriptManager-Steuerelement für ein Steuerelement mit UpdatePanel-Steuerelement mit Ausführung beim Senden des Formulars.

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 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 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 ausgeführt wird, bevor das Formular übermittelt wird, wodurch Sie die Übermittlung ändern oder abbrechen können.

Sie verwenden die RegisterOnSubmitStatement Methode, um eine onsubmit Anweisung zu rendern, die mit teilseitigem Rendering kompatibel ist und keine Abhängigkeiten von Microsoft Ajax Library aufweist. JavaScript-Code, der mithilfe dieser Methode registriert wird, wird nur an die Seite gesendet, wenn das Steuerelement, das die Anweisung registriert, innerhalb eines UpdatePanel Steuerelements befindet, das aktualisiert wird. Um Code mit jedem asynchronen Postback zu registrieren, verwenden Sie die RegisterOnSubmitStatement(Page, Type, String, String) Überladung dieser Methode.

Wenn Sie JavaScript-Code registrieren möchten, der sich nicht auf Teilseitenupdates bezieht, 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 Objekt aus der ClientScriptManager ClientScript Eigenschaft der Seite abrufen.

Der Skriptparameter der RegisterOnSubmitStatement Methode kann mehrere Skriptbefehle enthalten, die mithilfe von Semikolons (;)) getrennt werden.

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

Siehe auch

Gilt für