Metodo DataSource.CreateNavigator

Restituisce un oggetto XPathNavigator per accedere all'origine dati e modificarla.

Spazio dei nomi: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Sintassi

Public MustOverride Function CreateNavigator As XPathNavigator

Dim instance As DataSource
Dim returnValue As XPathNavigator

returnValue = instance.CreateNavigator

public abstract XPathNavigator CreateNavigator ()

Valore restituito

Oggetto XPathNavigator posizionato nel nodo principale dell'origine dati.

Osservazioni

Il metodo CreateNavigator consente di accedere a e di modificare a livello di programmazione i dati archiviati di un'origine dati rappresentata da un oggetto DataSource. Con l'origine dati, è possibile utilizzare tutti i metodi e le proprietà supportati dalla classe XPathNavigator.

Il metodo CreateNavigator sostituisce la proprietà DOM dell'oggetto DataObject utilizzato nel modello a oggetti di Microsoft InfoPath 2003.

Possono accedere a questo membro solo moduli eseguiti nello stesso dominio del modulo aperto oppure moduli a cui sono state concesse autorizzazioni tra domini.

A questo tipo o membro può accedere solo il codice in esecuzione in moduli aperti in Microsoft Office InfoPath 2007 o in un browser.

Esempio

Nell'esempio seguente viene creato un oggetto XPathNavigator per l'origine dati "CityList" utilizzando il metodo CreateNavigator e quindi il codice XML dell'origine dati viene visualizzato in una finestra di messaggio.

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

Vedere anche

Riferimenti

Classe DataSource
Membri DataSource
Spazio dei nomi Microsoft.Office.InfoPath