Vorgehensweise: Arbeiten mit Ansichten

Bei der Arbeit mit einer InfoPath-Formularvorlage können Sie Code schreiben, um auf die Ansichten des Formulars zuzugreifen, und dann eine Vielzahl von Aktionen für die in den Ansichten enthaltenen Daten ausführen. Das InfoPath-Objektmodell, das vom Microsoft.Office.InfoPath-Namespace bereitgestellt wird, unterstützt den Zugriff auf die Ansichten eines Formulars durch die Verwendung der Member der View-Klasse.

Übersicht über die View-Klasse

Die View-Klasse stellt die folgenden Methoden und Eigenschaften bereit, die Formularentwickler für die Interaktion mit einer InfoPath-Ansicht verwenden können.

Hinweis

Die Methoden und Eigenschaften der View-Klasse sind während des Loading-Ereignisses nicht verfügbar.

Name	Beschreibung
DisableAutoUpdate-Methode	Deaktiviert die automatische Synchronisierung zwischen dem einem Formular zugrunde liegenden XML-Dokument und der zugeordneten Ansicht.
EnableAutoUpdate-Methode	Aktiviert die automatische Synchronisierung zwischen dem einem Formular zugrunde liegenden XML-Dokument und der zugeordneten Ansicht.
ExecuteAction-Methode	Führt basierend auf den Daten, die zurzeit in der Ansicht ausgewählt sind, einen Bearbeitungsbefehl für das einem Formular zugrunde liegende XML-Dokument aus.
ExecuteAction-Methode	Führt basierend auf dem angegebenen Feld oder der angegebenen Gruppe einen Bearbeitungsbefehl für das einem Formular zugrunde liegende XML-Dokument aus.
Export-Methode	Exportiert die Ansicht in eine Datei des angegebenen Formats.
ForceUpdate-Methode	Erzwingt die Synchronisierung zwischen dem einem Formular zugrunde liegenden XML-Dokument und der zugeordneten Ansicht.
GetContextNodes-Methode	Ruft einen Verweis auf ein XPathNodeIterator-Objekt zum Durchlaufen der zurückgegebenen XML-Knoten beginnend beim angegebenen Knoten ab.
GetContextNodes-Methode	Ruft einen Verweis auf ein XPathNodeIterator-Objekt zum Durchlaufen der zurückgegebenen XML-Knoten in der aktuellen Auswahl innerhalb des an das angegebene Feld oder an die angegebene Gruppe gebundenen Steuerelements ab.
GetSelectedNodes-Methode	Ruft einen Verweis auf ein XPathNodeIterator-Objekt zum Durchlaufen aller XML-Knoten in der aktuellen Auswahl von Elementen in einer Ansicht ab.
SelectNodes-Methode	Wählt basierend auf dem angegebenen XML-Startknoten einen Bereich von Knoten in einer Ansicht aus.
SelectNodes-Methode	Wählt basierend auf dem angegebenen XML-Startknoten und XML-Endknoten einen Bereich von Knoten in einer Ansicht aus.
SelectNodes-Methode	Wählt basierend auf dem angegebenen XML-Startknoten, dem XML-Endknoten und dem angegebenen Steuerelement einen Bereich von Knoten in der Ansicht aus.
SelectText-Methode	Wählt den Text in einem bearbeitbaren Steuerelement aus, das an den Knoten gebunden ist, der durch das an diese Methode übergebene XPathNavigator-Objekt angegeben wird.
SelectText-Methode	Wählt den Text in einem bearbeitbaren Steuerelement aus, das an den Knoten gebunden ist, der durch das an diese Methode übergebene XPathNavigator-Objekt angegeben wird, und das angegebene Steuerelement.
ShowMailItem-Methode	Erstellt eine E-Mail-Nachricht, die die aktuelle Ansicht enthält.
ViewInfo-Eigenschaft	Ruft einen Verweis auf ein ViewInfo-Objekt ab, das der Ansicht zugeordnet ist.
Window-Eigenschaft	Ruft einen Verweis auf ein Window-Objekt ab, das der Ansicht zugeordnet ist.

Hinweis

Das InfoPath-Objektmodell stellt außerdem die Klassen ViewInfoCollection und ViewInfo bereit, die zum Abrufen von Informationen zu allen in einem Formular implementierten Ansichten verwendet werden können.

Verwenden der View-Klasse

Der Zugriff auf die View-Klasse erfolgt über die CurrentView-Eigenschaft der XmlForm-Klasse, auf die mithilfe des Schlüsselworts this (C#) oder Me (Visual Basic) zugegriffen wird. Das folgende Codebeispiel zeigt, wie ein Meldungsfeld mit dem Namen der aktiven Ansicht angezeigt wird.

MessageBox.Show("Current view name: " + 
   this.CurrentView.Name);

MessageBox.Show("Current view name: " & _
   Me.CurrentView.Name)

Alle InfoPath-Formularvorlagen enthalten mindestens eine Standardansicht; InfoPath unterstützt jedoch auch die Erstellung mehrerer Ansichten des einem Formular zugrunde liegenden XML-Dokuments. Wenn Sie mehrere Ansichten haben, kann ViewInfoCollection verwendet werden, um mit allen in der Formularvorlage implementierten Ansichten zu arbeiten. Verwenden Sie zum Zugreifen auf die ViewInfoCollection-Auflistung einer Formularvorlage die ViewInfos-Eigenschaft der XmlForm-Klasse. Mithilfe der SwitchView-Methode von ViewInfoCollection können Sie die derzeit aktive Ansicht programmgesteuert ändern, wie im folgenden Codebeispiel gezeigt wird:

this.ViewInfos.SwitchView("MySecondView");

Me.ViewInfos.SwitchView("MySecondView")

Das vorhergehende Beispiel zum Wechseln einer Ansicht ist nur nach dem Öffnen des Formulars funktionsfähig. Verwenden Sie zum Festlegen einer Standardansicht während des OnLoad-Ereignisses die Initial-Eigenschaft der ViewInfoCollection-Klasse wie im folgenden Beispiel gezeigt. Beachten Sie jedoch, dass dieser Wert erst wirksam wird, nachdem das Formular gespeichert und erneut geöffnet wurde.

this.ViewInfos.Initial = this.ViewInfos["MyInitialView"];

Me.ViewInfos.Initial = Me.ViewInfos["MyInitialView"];