Vorgehensweise: Anzeigen der Vorschau und Debuggen von InfoPath-Formularvorlagen mit verwaltetem Code

Microsoft Office InfoPath 2007 mit Microsoft Visual Studio Tools für Anwendungen (VSTA), Visual Studio 2005 mit Microsoft Visual Studio 2005 Tools für 2007 Microsoft Office System und Visual Studio 2008 mit Visual Studio Tools für Office ermöglicht das Debuggen durch Ausführen von Code im Vorschaumodus. Wenn Sie mit dem Debuggen von Formularcode beginnen, ist das Projekt kompiliert, und das Formular wird von InfoPath im InfoPath-Vorschaufenster angezeigt. Wenn eine Codezeile ermittelt wird, für die ein Haltepunkt festgelegt wurde, wird der Fokus auf den Code-Editor verschoben. Wenn Sie den Vorgang nach einem Haltepunkt fortsetzen, wird der Fokus wieder zum Vorschaufenster verschoben. Das Debuggen wird beendet, wenn Sie das Vorschaufenster schließen.

Sie können die Formularoptionen für die Formularvorlage auch so ändern, dass Vorschau und Debuggen mithilfe einer bestimmten Benutzerrolle, einer Beispieldatendatei oder durch Angeben der Domäne ausgeführt werden, in der das Formular veröffentlicht wird.

Sie können nach dem Festlegen von Haltepunkten im Code und nach dem Kompilieren der Formularvorlage die Formularvorlage im Bearbeitungsmodus öffnen, sie an den InfoPath-Prozess in Visual Studio anfügen und die Formularvorlage zur Laufzeit debuggen.

Hinweis:

Formularvorlagen können nicht zur Laufzeit über VSTA debuggt werden. Dazu zählen Formularvorlagen, die ausschließlich mit InfoPath kompatibel sind, sowie Formatvorlagen, die mit InfoPath und InfoPath Forms Services kompatibel sind.

Weitere Informationen zum Debuggen der Geschäftslogik von Formularvorlagen, die für InfoPath Forms Services von Visual Studio bereitgestellt wurden, finden Sie unter Vorgehensweise: Debuggen von in InfoPath Forms Services bereitgestellten browserfähigen Formularen.

Debuggen im Vorschaumodus

So debuggen Sie ein InfoPath-Projekt im Vorschaumodus

  1. Erstellen oder öffnen Sie in VSTA oder Visual Studio eine InfoPath-Formularvorlage mit verwaltetem Code.

  2. Legen Sie im Code-Editor im Formularcode mindestens einen Haltepunkt fest, indem Sie links neben der Codezeile, in der ein Haltepunkt eingefügt werden soll, auf die graue Leiste klicken.

    Ein roter Kreis wird angezeigt, und die Codezeile wird hervorgehoben, um darauf hinzuweisen, dass die Laufzeit an diesem Haltepunkt im Formularcode angehalten wird.

  3. Klicken Sie im Menü Debuggen auf Debuggen starten, oder drücken Sie F5.

    Das Projekt wird kompiliert und das Formular im Vorschaufenster angezeigt.

  4. Führen Sie eine Interaktion mit dem Formular aus, bis eine Codezeile mit einem Haltepunkt ermittelt wird.

    Der Fokus wechselt zurück zum Code-Editor.

  5. Klicken Sie im Menü Debuggen auf Weiter, oder drücken Sie F5.

  6. Wenn Sie das Debuggen abgeschlossen haben, schließen Sie das Vorschaufenster, oder klicken Sie im Menü Debuggen auf Debuggen beenden.

Hinweis:

Damit Sie eine InfoPath-Formularvorlage mit verwaltetem Code debuggen können, wenn Sie ein Objektmodellmember verwenden, das volle Vertrauenswürdigkeit erfordert, müssen Sie die Formularvorlage so konfigurieren wie unter Vorgehensweise: Anzeigen einer Vorschau und Debuggen von Formularvorlagen mit verwaltetem Code, die vollständig vertrauenswürdig sein müssen beschrieben.

Verwenden einer Beispieldatendatei

Standardmäßig wird für das Debuggen und die Vorschau die Datei "template.xml" verwendet, die beim Erstellen einer Formularvorlage erstellt wird. Sie können eine eigene Datendatei erstellen und angeben, dass diese Datei zum Anzeigen der Vorschau oder zum Debuggen verwendet wird, indem Sie eine der folgenden Verfahren verwenden.

So geben Sie eine Beispieldatendatei an, die beim Debuggen oder Anzeigen der Vorschau in VSTA verwendet werden soll

  1. Öffnen Sie die Formularvorlage im InfoPath-Entwurfsmodus, um die Datei "template.xml" anzuzeigen.

  2. Klicken Sie im Menü Datei auf Als Quelldateien speichern, speichern Sie die Dateien der Formularvorlage in einem Ordner, und öffnen Sie die Datei "template.xml" in einem Text-Editor.

  3. Erstellen Sie mit den gewünschten Beispieldaten eine Datei mit derselben Struktur wie die Datei "template.xml", und speichern Sie sie.

  4. Klicken Sie im Menü Datei auf Vorschau und dann auf Vorschau der Einstellungen.

  5. Geben Sie unter Beispieldaten die Beispieldatendatei an.

So geben Sie eine Beispieldatendatei an, die beim Debuggen oder Anzeigen der Vorschau in Visual Studio verwendet werden soll

  1. Öffnen Sie zum Anzeigen der Datei "template.xml" das Formularvorlagenprojekt in Visual Studio.

  2. Schließen Sie die Registerkarte manfest.xsf [Entwurf].

  3. Klicken Sie auf der Symbolleiste Projektmappen-Explorer auf Alle Dateien anzeigen, klicken Sie mit der rechten Maustaste auf "template.xml", und klicken Sie dann auf Öffnen.

  4. Markieren Sie die Inhalte der Datei "template.xml", und kopieren Sie sie.

  5. Zeigen Sie im Menü Datei auf Neu, klicken Sie auf Datei, und erstellen Sie eine XML-Datei.

  6. Fügen Sie die Inhalte der Datei "template.xml" in die neue Datei ein, und fügen Sie der Datei Beispieldaten hinzu.

  7. Klicken Sie im Menü Datei auf XMLFile1.xml speichern unter, und speichern Sie die Datei im Ordner "InfoPath-Formularvorlage" des Projekts.

  8. Öffnen Sie "manifest.xsf", klicken Sie im Menü Extras auf Formularoptionen, dann auf Vorschau, und geben Sie die Beispieldatendatei an.

Angeben einer Benutzerrolle zur Verwendung während des Debuggens oder des Anzeigens der Vorschau

Wenn für das Formular, mit dem Sie arbeiten, Benutzerrollen definiert wurden, können Sie eine Benutzerrolle angeben, die während des Debuggens oder des Anzeigens der Formularvorschau verwendet werden soll. Weitere Informationen zum Definieren von Benutzerrollen finden Sie in der InfoPath-Hilfe, wenn Sie nach "Benutzerrolle" suchen.

So geben Sie eine Rolle an, die während des Debuggens oder des Anzeigens der Vorschau verwendet werden soll

  1. Wenn Sie in InfoPath mit VSTA arbeiten, wechseln Sie zu InfoPath.

    Wenn Sie in Visual Studio arbeiten, klicken Sie auf die Registerkarte manfest.xsf [Entwurf].

  2. Klicken Sie im Menü Extras auf Formularoptionen.

  3. Klicken Sie auf Vorschau, und geben Sie dann die Benutzerrolle an, die im Dropdownfeld Vorschau anzeigen als verwendet werden soll.

Angeben einer Domäne zur Verwendung während des Debuggens oder des Anzeigens der Vorschau

Sie können eine Vorschau eines Formulars so anzeigen, als ob das Formular in einer bestimmten Domäne veröffentlicht würde. Diese Einstellung wird nur angewendet, wenn die Sicherheitsebene der Formularvorlage explizit auf Domäne festgelegt wurde.

So geben Sie eine Rolle an, die während des Debuggens oder des Anzeigens der Vorschau verwendet werden soll

  1. Wenn Sie in InfoPath mit VSTA arbeiten, wechseln Sie zu InfoPath.

    Wenn Sie in Visual Studio arbeiten, klicken Sie auf die Registerkarte manfest.xsf [Entwurf].

  2. Klicken Sie im Menü Extras auf Formularoptionen.

  3. Klicken Sie auf Vorschau, und geben Sie dann die Domäne an, die im Feld Domäne während des Debuggens und Anzeigens der Vorschau verwendet werden soll.

  4. Klicken Sie auf Sicherheit und Vertrauensstellung, deaktivieren Sie das Kontrollkästchen "Sicherheitsstufe automatisch ermitteln", und klicken Sie dann auf Domäne.

Debuggen zur Laufzeit

Wenn Sie die InfoPath-Formularvorlage in Microsoft Visual Studio 2005 Tools für 2007 Microsoft Office System oder Visual Studio 2008 mit Visual Studio Tools für Office entwickeln, können Sie die Formularvorlage zur Laufzeit mit dem folgenden Verfahren debuggen.

So debuggen Sie ein InfoPath-Projekt zur Laufzeit

  1. Öffnen Sie das Formularvorlagenprojekt in Visual Studio, legen Sie im Code mindestens einen Haltepunkt fest, kompilieren Sie die Formularvorlage wie unter Vorgehensweise: Bereitstellen von InfoPath-Projekten beschrieben, und stellen Sie sie bereit.

  2. Öffnen Sie in InfoPath die Formularvorlage im Bearbeitungsmodus.

  3. Klicken Sie in Visual Studio im Menü Extrasauf An den Prozess anhängen.

  4. Wählen Sie in der Liste Verfügbare Prozesse INFOPATH.EXE aus, und klicken Sie dann auf Anfügen.

  5. Arbeiten Sie mit dem Formular in InfoPath, bis ein Haltepunkt ermittelt wurde, und verwenden Sie dann die Tools zum Debuggen in Visual Studio.