ScriptManager.RegisterOnSubmitStatement Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Inscrit le code ECMAScript (JavaScript) qui est exécuté lors de l’envoi du formulaire.
Surcharges
| Nom | Description |
|---|---|
| RegisterOnSubmitStatement(Page, Type, String, String) |
Inscrit le code ECMAScript (JavaScript) auprès du ScriptManager contrôle d’un contrôle utilisé avec un UpdatePanel contrôle exécuté lors de l’envoi du formulaire. |
| RegisterOnSubmitStatement(Control, Type, String, String) |
Inscrit le code ECMAScript (JavaScript) auprès du ScriptManager contrôle d’un contrôle utilisé avec un UpdatePanel contrôle exécuté lors de l’envoi du formulaire. |
RegisterOnSubmitStatement(Page, Type, String, String)
Inscrit le code ECMAScript (JavaScript) auprès du ScriptManager contrôle d’un contrôle utilisé avec un UpdatePanel contrôle exécuté lors de l’envoi du formulaire.
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 -> unitPublic Shared Sub RegisterOnSubmitStatement (page As Page, type As Type, key As String, script As String)Paramètres
- page
- Page
Objet de page qui inscrit l’instruction onsubmit .
- type
- Type
Type de l’instruction de script client. Ce paramètre est généralement spécifié à l’aide de l’opérateur typeof (C#) ou de l’opérateur GetType (Visual Basic) pour récupérer le type du contrôle qui inscrit le script.
- key
- String
Identificateur unique de l’instruction de script.
- script
- String
Script à inscrire.
Exceptions
Remarques
L’inscription du code JavaScript avec cette méthode entraîne l’inclusion du script chaque fois qu’un postback asynchrone se produit.
Note
Le code des publications asynchrones antérieures n’est pas supprimé. De nouveaux postbacks asynchrones ajoutent du code à tout code existant pour l’instruction onsubmit .
Pour inscrire du code pour un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle afin que le code soit enregistré 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 concerne pas les mises à jour partielles de page et si vous souhaitez inscrire le code une seule fois pendant le 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
S’applique à
RegisterOnSubmitStatement(Control, Type, String, String)
Inscrit le code ECMAScript (JavaScript) auprès du ScriptManager contrôle d’un contrôle utilisé avec un UpdatePanel contrôle exécuté lors de l’envoi du formulaire.
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 -> unitPublic 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é à l’aide de l’opérateur typeof (C#) ou de l’opérateur GetType (Visual Basic) pour récupérer le type du contrôle qui inscrit le script.
- key
- String
Identificateur unique de l’instruction de script.
- script
- String
Script à inscrire.
Exceptions
control n’est pas dans l’arborescence de 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 onsubmit instruction compatible avec le rendu de pages partielles 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 en cours de mise à 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 concerne pas les mises à jour partielles de page et si vous souhaitez inscrire le code une seule fois pendant le 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 W3C (World Wide Web Consortium).
