FormEvents.Submit Événement

public:
 abstract event Microsoft::Office::InfoPath::SubmitEventHandler ^ Submit;

public abstract event Microsoft.Office.InfoPath.SubmitEventHandler Submit;

member this.Submit : Microsoft.Office.InfoPath.SubmitEventHandler 

Public MustOverride Custom Event Submit As SubmitEventHandler 

Type d'événement

Exceptions

Exemples

Dans l’exemple suivant, le gestionnaire d’événements de l’événement Submit est utilisé pour empêcher l’envoi du formulaire si le formulaire n’a pas été enregistré.

public void FormEvents_Submit(object sender, SubmitEventArgs e)
{
   if(this.Dirty || this.New)
      MessageBox.Show("Please save this form before submitting it.");
      e.CancelableArgs.Cancel = true;
   else
      e.CancelableArgs.Message = "Submit succeeded.";
}

Public Sub FormEvents_Submit(ByVal sender As Object, _
   ByVal e As SubmitEventArgs)
   If(Me.Dirty Or Me.New) Then
      MessageBox.Show("Please save this form before submitting it.")
      e.CancelableArgs.Cancel = True
   Else
      e.CancelableArgs.Message = "Submit succeeded."
   End If
End Sub

Remarques

Important : l’événement Submit n’est pas destiné à être instancié par le développeur dans le code du formulaire. Vous devez uniquement ajouter des gestionnaires d’événements pour les événements au niveau du formulaire à partir de l’interface utilisateur du mode création Microsoft InfoPath. Lorsque vous ajoutez un gestionnaire d’événements à votre modèle de formulaire à partir de l’interface utilisateur en mode Création, InfoPath génère du code dans la méthode InternalStartup de votre fichier de code de formulaire à l’aide de la EventManager classe et du membre de la FormEvents classe pour lier l’événement à son gestionnaire d’événements. Pour plus d'informations sur l'ajout de gestionnaires d'événements en mode Création dans InfoPath, consultez Procédure : Ajouter un gestionnaire d'événements.

L’événement Submit est déclenché uniquement si l’option Effectuer une action personnalisée à l’aide du code est définie dans la boîte de dialogue Options d’envoi.

L’événement Submit est lié à l’aide du SubmitEventHandler délégué.

L’événement Submit peut être annulé en utilisant la CancelableArgs propriété de la MergeEventArgs classe pour définir la propriété Cancel sur true.

Si le code du gestionnaire d’événements utilise la CancelableArgs propriété pour définir les chaînes des Message propriétés ou MessageDetails , mais que la propriété CancelableArgs.Cancel est laissée au paramètre par défaut false, un message de réussite s’affiche avec le texte des propriétés Message et MessageDetails . Ce message se substitue aux options de message personnalisé Afficher les messages de réussite et d'échec et En cas de réussite de la boîte de dialogue Options d'envoi de formulaire.

De même, si le code du gestionnaire d’événements définit les chaînes Message ou MessageDetails et définit CancelableArgs.Cancel sur true, un message d’échec s’affiche, le message s’affiche avec le texte des propriétés Message et MessageDetails , en remplaçant les paramètres de la boîte de dialogue Options d’envoi de formulaire.

Si le code du gestionnaire d’événements laisse les propriétés Message et MessageDetails à la valeur par défaut d’une référence Null (Nothing en Visual Basic), mais définit CancelableArgs.Cancel sur true, l’opération d’envoi est considérée comme ayant échoué. Les paramètres définis dans la boîte de dialogue Options d'envoi déterminent l'affichage éventuel d'un message et son contenu.

Les appels à la Quit() méthode de la Application classe ne peuvent pas être effectués dans le gestionnaire d’événements Submit .

Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.

S’applique à