DataSource.CreateNavigator, méthode
Renvoie un objet XPathNavigator pour accéder à la source de données et la modifier.
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustOverride Function CreateNavigator As XPathNavigator
'Utilisation
Dim instance As DataSource
Dim returnValue As XPathNavigator
returnValue = instance.CreateNavigator()
public abstract XPathNavigator CreateNavigator()
Valeur de retour
Type : System.Xml.XPath.XPathNavigator
Objet XPathNavigator placé sur le nœud racine de la source de données.
Remarques
La méthode CreateNavigator() vous permet d'accéder par programmation aux données stockées d'une source de données représentée par l'objet DataSource. Vous pouvez utiliser toutes les propriétés et méthodes prises en charge par la classe XPathNavigator pour travailler avec la source de données.
La méthode CreateNavigator() remplace la propriété DOM de l'objet DataObject utilisé par le modèle objet de Microsoft InfoPath 2003.
Ce membre est accessible uniquement par les formulaires qui s’exécutent dans le même domaine que le formulaire ouvert ou par les formulaires qui disposent d’autorisations valables pour plusieurs domaines.
Ce type ou ce membre est accessible à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur Web.
Exemples
Dans l'exemple suivant, un objet XPathNavigator est créé pour la source de données « CityList » via la méthode CreateNavigator(), puis le XML de la source de données s'affiche dans une boîte de message.
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())