XmlForm.MainDataSource, propriété
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
'Déclaration
Public MustOverride ReadOnly Property MainDataSource As DataSource
Get
'Utilisation
Dim instance As XmlForm
Dim value As DataSource
value = instance.MainDataSource
public abstract DataSource MainDataSource { get; }
Valeur de la propriété
Type : Microsoft.Office.InfoPath.DataSource
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 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 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