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 dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.
Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in 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())