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.
.gif) 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"];