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
Typ: System.Xml.XPath.XPathNavigator
Ein am Stammknoten der Datenquelle positioniertes XPathNavigator-Objekt.
Hinweise
Mithilfe der CreateNavigator()-Methode können Sie programmgesteuert auf die gespeicherten Daten einer durch das DataSource-Objekt dargestellten Datenquelle zugreifen und diese Daten bearbeiten. Sie können jede der von der XPathNavigator-Klasse unterstützten Eigenschaften und Methoden verwenden, 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 InfoPath Filler oder einem Webbrowser geöffnet wurden.
Beispiele
Im folgenden Beispiel wird ein XPathNavigator-Objekt für die Datenquelle "CityList" mithilfe der CreateNavigator()-Methode erstellt, und dann wird der XML-Code 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())