XmlForm.DataSources, propriété
Obtient l’objet DataSourceCollection associé au formulaire.
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustOverride ReadOnly Property DataSources As DataSourceCollection
Get
'Utilisation
Dim instance As XmlForm
Dim value As DataSourceCollection
value = instance.DataSources
public abstract DataSourceCollection DataSources { get; }
Valeur de la propriété
Type : Microsoft.Office.InfoPath.DataSourceCollection
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 DataSources[""] ou de la propriété MainDataSource.
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 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