Freigeben über


DataSource.CreateNavigator-Methode

Gibt ein XPathNavigator-Objekt zum Zugreifen auf die Datenquelle und zum Bearbeiten der Datenquelle zurück.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
Public MustOverride Function CreateNavigator As XPathNavigator
'Usage
Dim instance As DataSource
Dim returnValue As XPathNavigator

returnValue = instance.CreateNavigator
public abstract XPathNavigator CreateNavigator ()

Rückgabewert

Ein am Stammknoten der Datenquelle positioniertes XPathNavigator-Objekt.

Hinweise

Die CreateNavigator-Methode ermöglicht es Ihnen, auf die gespeicherten Daten einer durch das DataSource-Objekt dargestellten Datenquelle programmgesteuert zuzugreifen und sie zu bearbeiten. Sie können jede der Eigenschaften und Methoden verwenden, die von der XPathNavigator-Klasse unterstützt werden, um mit der Datenquelle zu arbeiten.

Die CreateNavigator-Methode ersetzt die DOM-Eigenschaft des im Microsoft InfoPath 2003-Objektmodell verwendeten DataObject-Objekts.

Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.

Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 oder einem Webbrowser geöffnet wurden.

Beispiel

Im folgenden Beispiel wird ein XPathNavigator-Objekt für die Datenquelle "CityList" mithilfe der CreateNavigator-Methode erstellt, und dann wird die XML der Datenquelle in einem Meldungsfeld angezeigt.

XPathNavigator myNavigator = 
   this.DataSources["CityList"].CreateNavigator();
MessageBox.Show("Data source XML: " + myNavigator.OuterXml.ToString());
Dim myNavigator As XPathNavigator  = 
   Me.DataSources("CityList").CreateNavigator()
MessageBox.Show("Data source XML: " & myNavigator.OuterXml.ToString())

Siehe auch

Referenz

DataSource-Klasse
DataSource-Member
Microsoft.Office.InfoPath-Namespace