Vorgehensweise: Reagieren auf Formularereignisse

Sie können Code schreiben, um auf unterschiedliche Ereignisse zu reagieren, die auftreten können, wenn ein Benutzer ein Formular ausfüllt. Zum Arbeiten mit Ereignissen in InfoPath fügen Sie Ereignishandler hinzu, während Sie mit einer Formularvorlage im Entwurfsmodus arbeiten.

InfoPath-Ereignishandler sollten immer im Entwurfsmodus erstellt werden, da InfoPath automatisch die richtige Deklaration zum Runtersetzen des Ereignisses der InternalStartup-Methode hinzufügt und die Codevorlage des Ereignishandlers in die Codedatei ("FormCode.cs" oder "FormCode.vb") eines Formulars einfügt. Nachdem Sie einen Ereignishandler erstellt haben, sollten Sie die zugehörige Deklaration in der Codedatei des Formulars nicht mehr ändern.

Weitere Informationen zum Erstellen der InfoPath-Ereignishandler finden Sie unter Vorgehensweise: Hinzufügen eines Ereignishandlers.

Übersicht über die Ereignisklassen

Das InfoPath-Modell, das vom Microsoft.Office.InfoPath-Namespace bereitgestellt wird, implementiert drei Klassen, die wiederum die 12 Ereignisse implementieren, die von Formularvorlagen-Geschäftslogik ausgelöst und behandelt werden können. In der folgenden Tabelle sind alle InfoPath-Ereignisobjekte, die Ereignisse, denen sie zugeordnet sind, sowie eine Beschreibung der durch sie bereitgestellten Funktionalität aufgeführt.

Hinweis:

Die Ereignisse Changed und Changing werden nur einmal ausgelöst, wenn eine Änderung in einem nicht leeren Feld des Formulars vorgenommen wird, während die vergleichbaren Ereignisse in InfoPath 2003 und in dem vom Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace bereitgestellten InfoPath 2003-kompatiblen Objektmodell (OnBeforeChange und OnAfterChange) bei Änderungen an einem nicht leeren Feld zweimal ausgelöst werden: wenn der alte Wert gelöscht wird und wenn der neue Wert eingefügt wird.

Übersicht über die EventArgs-Klassen

Jedem der 12 Ereignisse ist ein EventArgs-Objekt zugeordnet, das an den Ereignishandler für das Ereignis übergeben wird, um Statusinformationen und andere Funktionalität bereitzustellen, die im Ereignishandlercode verwendet werden können. Die folgende Tabelle listet die InfoPath-Ereignisse mit den ihnen zugeordneten EventArgs-Objekten und einer kurzen Beschreibung der durch die Eigenschaften und Methoden des Objekts bereitgestellten Funktionalität auf. Details zu den speziellen Eigenschaften und Methoden des Objekts erhalten Sie, indem Sie auf den Namen des EventArgs-Objekts in der Tabelle und dann auf den Hyperlink zu den Membern im Thema klicken.

Verwenden der EventArgs-Objekte

Beim Erstellen eines Ereignishandlers wird von InfoPath dessen Deklaration im Formularcode des Projekts erstellt. In der Deklaration des Ereignishandlers wird von InfoPath e als Name des Parameters verwendet, der an den Ereignishandler übergeben wird. Dieser Parameter enthält das EventArgs-Objekt, das dem Ereignishandler zugeordnet ist, um Statusinformationen und andere Funktionalität bereitzustellen, wenn das Ereignis eintritt.

Wenn Sie beispielsweise einen Ereignishandler für das Loading-Ereignis im Entwurfsmodus erstellen (zeigen Sie im Menü Extras auf Programmierung, und klicken Sie dann auf Loading-Ereignis), wird von InfoPath die Deklaration für den Ereignishandler, der das LoadingEventArgs-Objekt erhält, der Formularcodedatei hinzugefügt. Dann wird der Code-Editor geöffnet, damit Sie den Code der folgenden Ereignishändlerdeklaration hinzufügen können.

public void FormEvents_Loading(object sender, LoadingEventArgs e)
{
   // Write your code here.
}

Public Sub FormEvents_Loading(ByVal sender As Object, _
   ByVal e As LoadingEventArgs)
   ' Write your code here.
End Sub

Beim Schreiben von Code für einen Ereignishandler können Sie die Eigenschaften und Methoden verwenden, die vom EventArgs-Objekt implementiert werden, das durch den e-Parameter übergeben wird. Im folgenden Changing-Ereignishandler wird beispielsweise die NewValue-Eigenschaft des XmlChangingEventArgs-Objekts (das von der XmlEventArgs-Klasse geerbt wird) verwendet, um den Wert des Felds zu prüfen, das gerade geändert wurde. Wenn der Benutzer das Feld geändert und leer gelassen hat, wird auf die Message-Eigenschaft der XmlFormCancelEventArgs-Klasse mithilfe der CancelableArgs-Eigenschaft des XmlChangingEventArgs-Objekts zugegriffen, um dem Benutzer einen Fehler anzuzeigen, und die XmlFormCancelEventArgs.Cancel-Eigenschaft wird auf true festgelegt, um das Ereignis abzubrechen und ein Rollback für die Änderungen auszuführen, die der Benutzer vorgenommen hat.

public void field1_Changing(object sender, LoadingEventArgs e)
{
   // Determine whether there is a new value.
   if (e.NewValue == "")
   {
      // The value is blank, so display an error message
      // and roll back the changes.
      e.CancelableArgs.Message = 
         "You must supply a value for this field.";
      e.CancelableArgs.Cancel = true;
      return;
   }
}

Public Sub field1_Changing(ByVal sender As Object, _
   ByVal e As LoadingEventArgs)

   ' Determine whether there is a new value.
   If (e.NewValue = "") Then
      ' The value is blank, so display an error message 
      ' and roll back the changes.
      e.CancelableArgs.Message = _
         "You must supply a value for this field."
      e.CancelableArgs.Cancel = True
      Return
   End If
End Sub