_XDocument3.DataObjects - Propriété

  • Article

Obtient une référence à la collection DataObjectsCollection associée à un formulaire Microsoft InfoPath.

Espace de noms :  Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly :  Microsoft.Office.Interop.InfoPath.SemiTrust (dans Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Syntaxe

'Déclaration
ReadOnly Property DataObjects As DataObjectsCollection
    Get
'Utilisation
Dim instance As _XDocument3
Dim value As DataObjectsCollection

value = instance.DataObjects

DataObjectsCollection DataObjects { get; }

Valeur de propriété

Type : Microsoft.Office.Interop.InfoPath.SemiTrust.DataObjectsCollection

Implémentations

_XDocument2.DataObjects
_XDocument.DataObjects

Remarques

La collection DataObjects fournit un accès par programmation aux sources de données secondaires d'un formulaire. Chaque source de données secondaire est contenue dans un objet DataSourceObject de la collection DataObjects.

Important

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Exemples

Dans l'exemple suivant, la propriété DataObjects de l'objet XDocument est utilisée pour définir une référence à la source de données secondaire « CityList » :

DataSourceObject myDataObject = 
   (DataSourceObject)thisXDocument.DataObjects["CityList"];

Dim myDataObject As DataSourceObject = _
   DirectCast(thisXDocument.DataObjects["CityList"], DataSourceObject)

Dans l'exemple suivant, implémenté en tant que gestionnaire d'événements OnClick pour un bouton de formulaire, la propriété DataObjects de l'objet XDocument est utilisée pour définir une référence à la collection DataObjectsCollection. Le code exécute ensuite une boucle dans la collection et affiche l'index de position et le nom de chaque objet DataSourceObject qu'elle contient :

[InfoPathEventHandler(MatchPath="ShowDataObjectNames", EventType=InfoPathEventType.OnClick)]
public void ShowDataObjectNames_OnClick(DocActionEvent e)
{
   // Set a reference to the DataObjects collection.
   DataObjectsCollection dataObjects = thisXDocument.DataObjects;

   // Loop through the collection and display the name
   // of each DataObject object that it contains.
   for (int i=0; i < dataObjects.Count; i++)
   {
       thisXDocument.UI.Alert("Data object " + i + ": " + 
          dataObjects[i].Name);
   }
}

Voir aussi

Référence

_XDocument3 interface

_XDocument3 - Membres

DataObjects - Surcharge

Microsoft.Office.Interop.InfoPath.SemiTrust - Espace de noms