Freigeben über


Vorgehensweise: Hinzufügen eines Ereignishandlers

Die Verfahren zum Hinzufügen von Ereignishandlern für eine Formularvorlage für Microsoft Office InfoPath 2007 mit verwaltetem Code mithilfe von Microsoft Visual Studio Tools für Anwendungen (VSTA) sind ähnlich den Verfahren zum Hinzufügen von Ereignishandlern für Skript. Um beispielsweise einen Ereignishandler für das Loading-Ereignis hinzuzufügen, öffnen Sie die Formularvorlage im InfoPath-Entwurfsmodus, zeigen Sie im Menü Extras auf Programmierung, und klicken Sie dann auf Loading-Ereignis. Der Fokus wechselt automatisch zum Vorlagenereignishandler im VSTA-Code-Editor.

Die gleichen Verfahren werden von der Entwurfsmodusintegration von Visual Studio 2005 mit Microsoft Visual Studio 2005 Tools für 2007 Microsoft Office System oder von Visual Studio 2008 mit Visual Studio Tools für Office verwendet, mit der Ausnahme, dass Ereignishandler für Ereignisse auf Formularebene (die Ereignisse Loading, ViewSwitched, ContextChanged und Sign) hinzugefügt werden. Diese Unterschiede werden in den folgenden Verfahren hervorgehoben.

Wichtig

Durch das Hinzufügen eines Ereignishandlers wird Ereignisbindungscode in der InternalStartup-Methode der Datei "FormCode.cs" oder "FormCode.vb" im Formularvorlagenprojekt generiert. Sie sollten die InternalStartup-Methode nicht selbst erstellen oder zusätzlichen Code darin hinzufügen.

Hinzufügen eines Ereignishandlers für das Click-Ereignis eines Schaltflächen-Steuerelements

  1. Wenn Sie in InfoPath arbeiten, öffnen Sie die Formularvorlage im Entwurfsmodus.

    Wenn Sie in Visual Studio arbeiten, öffnen Sie ein Projekt des Typs InfoPath-Formularvorlage.

  2. Ziehen Sie aus dem Aufgabenbereich Steuerelemente oder aus der Visual Studio-Toolbox eine Schaltfläche auf das Formular.

  3. Doppelklicken Sie auf die Schaltfläche, und klicken Sie dann auf Formularcode bearbeiten.

    Der Fokus wechselt zum Vorlagenereignishandler für das Clicked-Ereignis im VSTA- oder Visual Studio-Code-Editor.

Hinzufügen eines Ereignishandlers für das Ereignis "Changing", "Validating" oder "Changed" eines Felds oder einer Gruppe

  1. Wenn Sie in InfoPath arbeiten, öffnen Sie die Formularvorlage im Entwurfsmodus.

    Wenn Sie in Visual Studio arbeiten, öffnen Sie ein Projekt des Typs InfoPath-Formularvorlage.

  2. Klicken Sie mit der rechten Maustaste auf ein an das Feld oder die Gruppe gebundenes Dateneingabe-Steuerelement, wie z. B. ein Steuerelement vom Typ Textfeld.

  3. Zeigen Sie auf Programmierung, und klicken Sie dann auf das Ereignis, für das Sie einen Ereignishandler erstellen möchten. Der Fokus wechselt zum Vorlagenereignishandler für das Ereignis Changing, Validating oder Changed im VSTA- oder Visual Studio-Code-Editor.

    Hinweis

    Wenn Sie beim Erstellen der Formularvorlage im Dialogfeld Formular entwerfen das Kontrollkästchen Nur browserkompatible Features aktivieren aktiviert haben oder wenn Sie im Dialogfeld Formularoptionen in der Kategorie Kompatibilität das Kontrollkästchen Entwerfen Sie eine Formularvorlage, die in einem Browser oder in InfoPath geöffnet werden kann aktiviert haben, ist der Befehl für das Changing-Ereignis nicht verfügbar. Das liegt daran, dass Ereignishandler für das Changing-Ereignis in der Geschäftslogik von Formularvorlagen, die in Dokumentbibliotheken unter Microsoft Office Forms Server 2007 oder Microsoft Office SharePoint Server 2007 mit InfoPath Forms Services veröffentlicht werden, nicht unterstützt werden.

Hinzufügen eines Ereignishandlers für die Ereignisse "Loading", "ViewSwitched", "ContextChanged" und "Sign" eines Formulars

  1. Wenn Sie in InfoPath arbeiten, öffnen Sie die Formularvorlage im Entwurfsmodus.

    Wenn Sie in Visual Studio arbeiten, öffnen Sie ein Projekt des Typs InfoPath-Formularvorlage.

  2. Zeigen Sie in InfoPath im Menü Extras auf Programmierung, und klicken Sie dann auf das Formularereignis, für das Sie einen Ereignishandler erstellen möchten.

    Zeigen Sie in Visual Studio im Menü Einfügen auf Ereignis, und klicken Sie dann auf das Formularereignis, für das Sie einen Ereignishandler erstellen möchten.

    Der Fokus wechselt zum Vorlagenereignishandler für das Ereignis Loading, ViewSwitched, ContextChanged oder Sign im VSTA- oder Visual Studio-Code-Editor.

    Hinweis

    Wenn Sie beim Erstellen der Formularvorlage im Dialogfeld Formular entwerfen das Kontrollkästchen Nur browserkompatible Features aktivieren aktiviert haben oder wenn Sie im Dialogfeld Formularoptionen in der Kategorie Kompatibilität das Kontrollkästchen Entwerfen Sie eine Formularvorlage, die in einem Browser oder in InfoPath geöffnet werden kann aktiviert haben, ist der Befehl für das Context Changed-Ereignis oder das Sign-Ereignis nicht verfügbar. Das liegt daran, dass Ereignishandler für die Ereignisse ContextChanged und Sign in der Geschäftslogik von Formularvorlagen, die in Dokumentbibliotheken unter Microsoft Office Forms Server 2007 oder Microsoft Office SharePoint Server 2007 mit InfoPath Forms Services veröffentlicht werden, nicht unterstützt werden.

Hinzufügen eines Ereignishandlers für das Submit-Ereignis eines Formulars

  1. Wenn Sie in InfoPath arbeiten, öffnen Sie die Formularvorlage im Entwurfsmodus.

    Wenn Sie in Visual Studio arbeiten, öffnen Sie ein Projekt des Typs InfoPath-Formularvorlage, und klicken Sie dann auf die Registerkarte manifest.xsf [Entwurf], um den Formular-Designer anzuzeigen.

  2. Klicken Sie im Menü Extras auf Formularsendeoptionen.

  3. Klicken Sie auf Übermitteln dieses Formulars durch Benutzer zulassen, klicken Sie auf Benutzerdefinierte Aktion mithilfe von Code ausführen, und klicken Sie dann auf Code bearbeiten.

    Der Fokus wechselt zum Vorlagenereignishandler für das Submit-Ereignis im VSTA- oder Visual Studio-Code-Editor.

Hinzufügen eines Ereignishandlers für das Save-Ereignis eines Formulars

  1. Wenn Sie in InfoPath arbeiten, öffnen Sie die Formularvorlage im Entwurfsmodus.

    Wenn Sie in Visual Studio arbeiten, öffnen Sie ein Projekt des Typs InfoPath-Formularvorlage, und klicken Sie dann auf die Registerkarte manifest.xsf [Entwurf], um den Formular-Designer anzuzeigen.

  2. Klicken Sie im Menü Extras auf Formularoptionen.

  3. Klicken Sie auf die Kategorie Öffnen und Speichern, aktivieren Sie das Kontrollkästchen Speichern erfolgt mittels benutzerdefiniertem Code, und klicken Sie dann auf Bearbeiten.

    Der Fokus wechselt zum Vorlagenereignishandler für das Save-Ereignis im VSTA- oder Visual Studio-Code-Editor.

    Hinweis

    Wenn Sie beim Erstellen der Formularvorlage im Dialogfeld Formular entwerfen das Kontrollkästchen Nur browserkompatible Features aktivieren aktiviert haben oder wenn Sie im Dialogfeld Formularoptionen in der Kategorie Kompatibilität das Kontrollkästchen Entwerfen Sie eine Formularvorlage, die in einem Browser oder in InfoPath geöffnet werden kann aktiviert haben, ist das Kontrollkästchen Speichern erfolgt mittels benutzerdefiniertem Code nicht verfügbar. Das liegt daran, dass Ereignishandler für das Save-Ereignis in der Geschäftslogik von Formularvorlagen, die in Dokumentbibliotheken unter Microsoft Office Forms Server 2007 oder Microsoft Office SharePoint Server 2007 mit InfoPath Forms Services veröffentlicht werden, nicht unterstützt werden.

Hinzufügen eines Ereignishandlers für das VersionUpgrade-Ereignis eines Formulars

  1. Wenn Sie in InfoPath arbeiten, öffnen Sie die Formularvorlage im Entwurfsmodus.

    Wenn Sie in Visual Studio arbeiten, öffnen Sie ein Projekt des Typs InfoPath-Formularvorlage, und klicken Sie dann auf die Registerkarte manifest.xsf [Entwurf], um den Formular-Designer anzuzeigen.

  2. Klicken Sie im Menü Extras auf Formularoptionen.

  3. Klicken Sie auf die Kategorie Programmierung, wählen Sie im Dropdownfeld Bei Versionsaktualisierung die Option Benutzerdefiniertes Ereignis verwenden aus, und klicken Sie dann auf Bearbeiten.

    Der Fokus wechselt zum Vorlagenereignishandler für das Save-Ereignis im VSTA- oder Visual Studio-Code-Editor.

Hinzufügen eines Ereignishandlers für das Merge-Ereignis eines Formulars

  1. Wenn Sie in InfoPath arbeiten, öffnen Sie die Formularvorlage im Entwurfsmodus.

    Wenn Sie in Visual Studio arbeiten, öffnen Sie ein Projekt des Typs InfoPath-Formularvorlage, und klicken Sie dann auf die Registerkarte manifest.xsf [Entwurf], um den Formular-Designer anzuzeigen.

  2. Klicken Sie im Menü Extras auf Formularoptionen.

  3. Klicken Sie auf die Kategorie Erweitert, klicken Sie auf das Kontrollkästchen Zusammenführen von Formularen aktivieren, und klicken Sie dann auf Bearbeiten.

    Der Fokus wechselt zum Vorlagenereignishandler für das Merge-Ereignis im VSTA- oder Visual Studio-Code-Editor.

    Hinweis

    Wenn Sie beim Erstellen der Formularvorlage im Dialogfeld Formular entwerfen das Kontrollkästchen Nur browserkompatible Features aktivieren aktiviert haben oder wenn Sie im Dialogfeld Formularoptionen in der Kategorie Kompatibilität das Kontrollkästchen Entwerfen Sie eine Formularvorlage, die in einem Browser oder in InfoPath geöffnet werden kann aktiviert haben, ist Zusammenführen von Formularen aktivieren nicht verfügbar. Das liegt daran, dass Ereignishandler für das Merge-Ereignis in der Geschäftslogik von Formularvorlagen, die in Dokumentbibliotheken in Microsoft Office Forms Server 2007 oder Microsoft Office SharePoint Server 2007 mit InfoPath Forms Services veröffentlicht werden, nicht unterstützt werden.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Erstellen und Debuggen einer einfachen Formularvorlage mit dem InfoPath 2003-Objektmodell