DataSource.CreateNavigator (Método)

Devuelve un objeto XPathNavigator para tener acceso al origen de datos y modificarlo.

Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en microsoft.office.infopath.dll)

Sintaxis

'Declaración
Public MustOverride Function CreateNavigator As XPathNavigator
'Uso
Dim instance As DataSource
Dim returnValue As XPathNavigator

returnValue = instance.CreateNavigator

public abstract XPathNavigator CreateNavigator ()

Valor devuelto

Objeto XPathNavigator situado en el nodo raíz del origen de datos.

Comentarios

El método CreateNavigator permite, mediante programación, tener acceso a los datos almacenados de un origen de datos representado por el objeto DataSource, así como modificarlos. Se puede usar cualquiera de las propiedades y métodos compatibles con la clase XPathNavigator para trabajar con el origen de datos.

El método CreateNavigator reemplaza a la propiedad DOM del objeto DataObject utilizada en el modelo de objetos de Microsoft InfoPath 2003.

Sólo pueden tener acceso a este miembro los formularios que se ejecuten en el mismo dominio que el formulario abierto actualmente o los formularios a los que se hayan concedido permisos entre dominios.

Se puede tener acceso a este tipo o miembro desde un código ejecutado en formularios abiertos en Microsoft Office InfoPath 2007 o en un explorador Web.

Ejemplo

En el ejemplo siguiente, se crea un objeto XPathNavigator para el origen de datos "CityList" mediante el método CreateNavigator y, a continuación, se muestra el código XML del origen de datos en un cuadro de mensaje.

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())

Vea también

Referencia

DataSource (Clase)
DataSource (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)