Compartir a través de


de la propiedad _XDocument3.DataObjects

Obtiene una referencia a la colección DataObjectsCollection que está asociada con un formulario de Microsoft InfoPath.

Espacio de nombres:  Microsoft.Office.Interop.InfoPath.SemiTrust
Ensamblado:  Microsoft.Office.Interop.InfoPath.SemiTrust (en Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Sintaxis

'Declaración
ReadOnly Property DataObjects As DataObjectsCollection
    Get
'Uso
Dim instance As _XDocument3
Dim value As DataObjectsCollection

value = instance.DataObjects
DataObjectsCollection DataObjects { get; }

Valor de propiedad

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

Implementaciones

_XDocument2.DataObjects
_XDocument.DataObjects

Comentarios

La colección DataObjects proporciona acceso mediante programación a los orígenes de datos secundarios de un formulario. Cada origen de datos secundario está contenido en un objeto DataSourceObject de la colección DataObjects.

Importante

Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.

Ejemplos

En el siguiente ejemplo, la propiedad DataObjects del objeto XDocument se utiliza para establecer una referencia al origen de datos secundario "CityList":

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

En el siguiente ejemplo, implementado como controlador de eventos OnClick para un botón en un formulario, la propiedad DataObjects del objeto XDocument se utiliza para establecer una referencia a la colección DataObjectsCollection. A continuación, el código efectúa una operación de bucle en la colección y muestra el nombre y el índice posicional de cada objeto DataSourceObject que contiene:

[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);
   }
}

Vea también

Referencia

interfaz _XDocument3

Miembros _XDocument3

Sobrecarga DataObjects

Espacio de nombres Microsoft.Office.Interop.InfoPath.SemiTrust