XmlForm.DataSources, propriété

Article
04/27/2010

Obtient l'objet DataSourceCollection associé au formulaire.

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

Syntaxe

Public MustOverride ReadOnly Property DataSources As DataSourceCollection

Dim instance As XmlForm
Dim value As DataSourceCollection

value = instance.DataSources

public abstract DataSourceCollection DataSources { get; }

Valeur de la propriété

Collection DataSourceCollection qui contient tous les objets DataSource associés au formulaire.

Remarques

L'objet DataSourceCollection contient une collection d'objets DataSource qui représentent toutes les sources de données externes (secondaires) associées au modèle de formulaire. L'objet DataSourceCollection comprend également un objet DataSource qui représente la source de données principale du formulaire. En d'autres termes, les développeurs disposent de deux méthodes pour renvoyer l'objet DataSource qui représente la source de données principale : à l'aide de DataSourceCollection[""] ou de la propriété MainDataSource.

Remarque
La propriété DataSources fournit des fonctionnalités équivalentes à celles de la propriété DataObjects de l'objet XDocument dans le modèle objet de script/COM et de la propriété DataObjects de l'interface _XDocument2 du modèle objet de code managé compatible avec 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 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 suivant, la propriété DataSources de la classe XmlForm est utilisée pour définir une référence à la source de données secondaire « CityList » :

DataSource myDataSource = this.DataSources["CityList"];

Dim myDataSource As DataSource = Me.DataSources("CityList")

L'exemple suivant, qui implémente un gestionnaire d'événements pour un contrôle Bouton d'un formulaire, utilise la propriété DataSources de l'objet XmlForm pour définir une référence à la collection DataSourceCollection du formulaire. Le code parcourt la collection et affiche l'index de position et le nom de chaque objet DataSource qu'elle contient.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   // Set a reference to the DataSources collection.
   DataSourceCollection myDataSources = this.DataSources;

   // Loop through the collection and display the name
   // of each DataSource object that it contains.
   for (int i = 0; i < myDataSources.Count; i++)
   {
      MessageBox.Show("Data source " + i + ": " + 
         myDataSources[i].Name);
   }
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   ' Set a reference to the DataSources collection.
   Dim myDataSources As DataSourceCollection = Me.DataSources

   ' Loop through the collection and display the name
   ' of each DataSource object that it contains.
   Dim i As Integer
   For i = 0 To myDataSources.Count - 1
      MessageBox.Show("Data source " & i & ": " _
         & myDataSources(i).Name)
   Next
End Sub

Voir aussi

Référence

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

Partager via