FormEvents.Submit-Ereignis

Artikel
04/27/2010

Tritt ein, wenn der Befehl Absenden von der Benutzeroberfläche verwendet wird, oder bei Verwendung der Submit-Methode.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
Public Event Submit As SubmitEventHandler
'Usage
Dim instance As FormEvents
Dim handler As SubmitEventHandler

AddHandler instance.Submit, handler

public abstract event SubmitEventHandler Submit

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Es wurde versucht, das Ereignis an einen anderen Speicherort als die InternalStartup-Methode zu binden.

Hinweise

Wichtig

Das Submit-Ereignis sollte nicht im Formularcode instanziiert werden. Ereignishandler sollten Ereignissen auf Formularebene nur von der Microsoft Office InfoPath 2007-Entwurfsmodus-Benutzeroberfläche aus hinzugefügt werden. Wenn Sie der Formularvorlage von der Entwurfsmodus-Benutzeroberfläche aus einen Ereignishandler hinzufügen, wird in InfoPath mithilfe der EventManager-Klasse und mithilfe des Members der FormEvents-Klasse in der InternalStartup-Methode der Formularcodedatei Code generiert, um das Ereignis an den zugehörigen Ereignishandler zu binden. Weitere Informationen zum Hinzufügen von Ereignishandlern im InfoPath-Entwurfsmodus finden Sie unter Vorgehensweise: Hinzufügen eines Ereignishandlers.

Das Submit-Ereignis wird nur ausgelöst, wenn in der Formularvorlage im Dialogfeld Absendeoptionen die Option Benutzerdefinierte Aktion mithilfe von Code ausführen festgelegt ist.

Die Bindung des Submit-Ereignisses erfolgt mithilfe des SubmitEventHandler-Delegaten.

Das Submit-Ereignis kann mithilfe der CancelableArgs-Eigenschaft der MergeEventArgs-Klasse abgebrochen werden, um die Cancel-Eigenschaft auf true festzulegen.

Wenn Ereignishandlercode mithilfe der CancelableArgs-Eigenschaft die Zeichenfolgen der Message- oder MessageDetails-Eigenschaften festlegt, jedoch die CancelableArgs.Cancel-Eigenschaft mit der Standardeinstellung false übernimmt, dann wird eine Erfolgsmeldung mit dem Text der Message- und MessageDetails-Eigenschaften angezeigt. Diese Meldung setzt im Dialogfeld Absendeoptionen die benutzerdefinierten Meldungseinstellungen Meldungen bei Erfolg oder bei Fehler anzeigen und Bei Erfolg außer Kraft.

Das gleiche gilt, wenn der Ereignishandlercode die Message- oder MessageDetails-Zeichenfolge festlegt, und dabei CancelableArgs.Cancel auf true festlegt, dann wird eine Fehlermeldung angezeigt. Die Meldung wird mit dem Text der Message- und MessageDetails-Eigenschaften angezeigt, wobei die Einstellungen des Dialogfeldes Absendeoptionen außer Kraft gesetzt werden.

Wenn der Ereignishandlercode den Standardwert null für die Message- und MessageDetails-Eigenschaften übernimmt, jedoch CancelableArgs.Cancel auf true festlegt, dann wird der Sendevorgang einen Fehler zurückgeben. Ob und welche Fehlermeldung angezeigt wird, ist abhängig von den Einstellungen des Dialogfeldes Absendeoptionen.

Aufrufe der Quit-Methode der Application-Klasse sind im Submit-Ereignishandler nicht möglich.

Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 oder einem Webbrowser geöffnet wurden.

Beispiel

Im folgenden Beispiel wird mit dem Ereignishandler des Submit-Ereignisses das Absenden des Formulars vermieden, wenn das Formular nicht gespeichert wurde.

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

Siehe auch

Referenz

FormEvents-Klasse
FormEvents-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über