FormEvents.Submit Ereignis

Definition

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Tritt auf, wenn der Befehl Submit über die Benutzeroberfläche oder die Submit() -Methode verwendet wird.

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 

Ereignistyp

SubmitEventHandler

Ausnahmen

InvalidOperationException

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

Beispiele

Im folgenden Beispiel wird der Ereignishandler für das Submit Ereignis verwendet, um zu verhindern, dass das Formular gesendet wird, 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

Hinweise

Wichtig: Das Submit Ereignis soll nicht vom Entwickler im Formularcode instanziiert werden. Sie sollten nur Ereignishandler für Ereignisse auf Formularebene über die Benutzeroberfläche des Microsoft InfoPath-Entwurfsmodus hinzufügen. Wenn Sie ihrer Formularvorlage über die Benutzeroberfläche des Entwurfsmodus einen Ereignishandler hinzufügen, generiert InfoPath Code in der InternalStartup-Methode Ihrer Formularcodedatei mithilfe der EventManager -Klasse und des Members der FormEvents -Klasse, um das Ereignis an ihren 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 für die Formularvorlage die Option Benutzerdefinierte Aktion mit Code ausführen im Dialogfeld Übermittlungsoptionen festgelegt ist.

Das Submit Ereignis wird mithilfe des SubmitEventHandler Delegaten gebunden.

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

Wenn der Ereignishandlercode die CancelableArgs -Eigenschaft verwendet, um die Zeichenfolgen der - oder MessageDetails -MessageEigenschaften festzulegen, die CancelableArgs.Cancel-Eigenschaft jedoch die Standardeinstellung false belässt, wird eine Erfolgsmeldung mit dem Text der Eigenschaften Message und MessageDetails angezeigt. Diese Meldung setzt im Dialogfeld Absendeoptionen die benutzerdefinierten Meldungseinstellungen Meldungen bei Erfolg oder bei Fehler anzeigen und Bei Erfolg außer Kraft.

Wenn der Ereignishandlercode die Zeichenfolgen Message oder MessageDetails festlegt und CancelableArgs.Cancel auf true festlegt, wird eine Fehlermeldung angezeigt, die mit dem Text der Eigenschaften Message und MessageDetails angezeigt wird, wobei die Einstellungen des Dialogfelds Formularabsendeoptionen überschrieben werden.

Wenn der Ereignishandlercode sowohl die Eigenschaften Message als auch MessageDetails beim Standardwert eines NULL-Verweises (Nothing in Visual Basic) belässt, aber CancelableArgs.Cancel auf true festlegt, wird der Übermittlungsvorgang als fehlgeschlagen betrachtet. Ob und welche Fehlermeldung angezeigt wird, ist abhängig von den Einstellungen des Dialogfeldes Absendeoptionen.

Aufrufe der Quit() -Methode der Application -Klasse können nicht im Submit Ereignishandler ausgeführt werden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.