XmlForm.MainDataSource, propriété

Article
04/27/2010

Obtient un objet DataSource qui représente la source de données principale du formulaire.

Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans microsoft.office.infopath.dll)

Syntaxe

Public MustOverride ReadOnly Property MainDataSource As DataSource

Dim instance As XmlForm
Dim value As DataSource

value = instance.MainDataSource

public abstract DataSource MainDataSource { get; }

Valeur de la propriété

Objet DataSource qui représente la source de données principale du formulaire.

Remarques

La propriété MainDataSource obtient une référence à un objet DataSource qui représente le document XML sous-jacent du formulaire. Cet objet peut être ensuite utilisé pour accéder aux propriétés et méthodes de la classe DataSource afin de manipuler les données figurant dans le document XML sous-jacent du formulaire.

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 indépendantes des domaines.

Ce type ou ce membre est accessible à partir du code exécuté dans les formulaires ouverts dans Microsoft Office InfoPath 2007 ou un navigateur Web.

Exemple

Dans l'exemple de code suivant, un gestionnaire de l'événement Loading utilise d'abord la propriété MainDataSource pour appeler la méthode CreateNavigator de la classe DataSource et créer une instance de la classe System.Xml.XPath.XPathNavigator placée au niveau du nœud racine du document XML sous-jacent du formulaire. Après quoi, il utilise la méthode SelectSingleNode de l'objet XPathNavigator pour accéder au champ employé (en résolvant les préfixes d'espace de noms à l'aide de la propriété NamespaceManager) et affecter à ce champ le nom d'utilisateur de l'utilisateur actuel.

public void FormEvents_Loading(object sender, LoadingEventArgs e)
{
   // Create XPathNavigator positioned at the root of the main data 
   // source.
   XPathNavigator myNav = this.MainDataSource.CreateNavigator()

   // Select employee field and set value to username.
   myNav.SelectSingleNode("//my:employee",this.NamespaceManager).
      SetValue(System.Environment.UserName);
}

Public Sub FormEvents_Loading(ByVal sender As Object, ByVal e As LoadingEventArgs)
   ' Create XPathNavigator positioned at the root of the main data 
   ' source.
   Dim myNav As XPathNavigator = Me.MainDataSource.CreateNavigator()

   ' Select employee field and set value to username.
   myNav.SelectSingleNode("//my:employee", Me.NamespaceManager). _
      SetValue(System.Environment.UserName)
End Sub

Voir aussi

Référence

XmlForm, classe
Membres XmlForm
Microsoft.Office.InfoPath, espace de noms

Partager via