ScriptManager.RegisterOnSubmitStatement Méthode

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Inscrit le code ECMAScript (JavaScript) exécuté quand le formulaire est envoyé.

Surcharges

RegisterOnSubmitStatement(Page, Type, String, String)	Inscrit le code ECMAScript (JavaScript) avec le contrôle ScriptManager pour un contrôle utilisé avec un contrôle UpdatePanel exécuté quand le formulaire est envoyé.
RegisterOnSubmitStatement(Control, Type, String, String)	Inscrit le code ECMAScript (JavaScript) avec le contrôle ScriptManager pour un contrôle utilisé avec un contrôle UpdatePanel exécuté quand le formulaire est envoyé.

RegisterOnSubmitStatement(Page, Type, String, String)

Inscrit le code ECMAScript (JavaScript) avec le contrôle ScriptManager pour un contrôle utilisé avec un contrôle UpdatePanel exécuté quand le formulaire est envoyé.

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)

Paramètres

page

Page

Objet page qui inscrit l'instruction onsubmit.

type

Type

Type de l'instruction de script client. Ce paramètre est généralement spécifié en utilisant l'opérateur typeof (C#) ou l'opérateur GetType (Visual Basic) pour récupérer le type du contrôle qui inscrit le script.

key

String

Identificateur unique pour l'instruction de script.

script

String

Le script à inscrire.

Exceptions

ArgumentNullException

page a la valeur null.

-ou- type a la valeur null.

Remarques

L’inscription du code JavaScript avec cette méthode entraîne l’inclusion du script chaque fois qu’une publication asynchrone se produit.

Notes

Le code des publications asynchrones antérieures n’est pas supprimé. Les nouvelles publications asynchrones ajoutent du code à tout code existant pour l’instruction onsubmit .

Pour inscrire du code pour un contrôle à l’intérieur d’un UpdatePanel contrôle afin que le code soit inscrit uniquement lorsque le UpdatePanel contrôle est mis à jour, utilisez la RegisterOnSubmitStatement(Control, Type, String, String) surcharge de cette méthode.

Si vous souhaitez inscrire du code JavaScript qui ne se rapporte pas aux mises à jour partielles de page, et si vous souhaitez inscrire le code une seule fois lors du rendu de page initial, utilisez la RegisterOnSubmitStatement méthode de la ClientScriptManager classe. Vous pouvez obtenir une référence à l’objet ClientScriptManager à partir de la ClientScript propriété de la page.

Voir aussi

• RegisterOnSubmitStatement(Control, Type, String, String)

RegisterOnSubmitStatement(Control, Type, String, String)

Inscrit le code ECMAScript (JavaScript) avec le contrôle ScriptManager pour un contrôle utilisé avec un contrôle UpdatePanel exécuté quand le formulaire est envoyé.

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)

Paramètres

control

Control

Contrôle qui inscrit l'instruction onsubmit.

type

Type

Type de l'instruction de script client. Ce paramètre est généralement spécifié en utilisant l'opérateur typeof (C#) ou l'opérateur GetType (Visual Basic) pour récupérer le type du contrôle qui inscrit le script.

key

String

Identificateur unique pour l'instruction de script.

script

String

Le script à inscrire.

Exceptions

ArgumentNullException

control a la valeur null.

-ou- type a la valeur null.

ArgumentException

control n'est pas dans l'arborescence du contrôle de la page.

Remarques

Le RegisterOnSubmitStatement script ajoute qui est exécuté avant l’envoi du formulaire, ce qui vous permet de modifier la soumission ou de l’annuler.

Vous utilisez la RegisterOnSubmitStatement méthode pour afficher une instruction compatible avec le onsubmit rendu de page partielle et qui n’a aucune dépendance de bibliothèque Microsoft Ajax. Le code JavaScript inscrit à l’aide de cette méthode est envoyé à la page uniquement lorsque le contrôle qui inscrit l’instruction se trouve à l’intérieur d’un UpdatePanel contrôle mis à jour. Pour inscrire du code avec chaque publication asynchrone, utilisez la RegisterOnSubmitStatement(Page, Type, String, String) surcharge de cette méthode.

Si vous souhaitez inscrire du code JavaScript qui ne se rapporte pas aux mises à jour partielles de page, et si vous souhaitez inscrire le code une seule fois lors du rendu de page initial, utilisez la RegisterOnSubmitStatement méthode de la ClientScriptManager classe. Vous pouvez obtenir une référence à l’objet ClientScriptManager à partir de la ClientScript propriété de la page.

Le paramètre de script de la RegisterOnSubmitStatement méthode peut contenir plusieurs commandes de script délimitées à l’aide de points-virgules (;)).

Pour plus d’informations sur les formulaires HTML et l’événementonsubmit, consultez le site web World Wide Web Consortium (W3C).

Voir aussi

• RegisterOnSubmitStatement(Page, Type, String, String)