_XDocument3.DataObjects Propiedad

Definición

Espacio de nombres:

Microsoft.Office.Interop.InfoPath.SemiTrust

Ensamblado:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

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

public:
 property Microsoft::Office::Interop::InfoPath::SemiTrust::DataObjectsCollection ^ DataObjects { Microsoft::Office::Interop::InfoPath::SemiTrust::DataObjectsCollection ^ get(); };

public Microsoft.Office.Interop.InfoPath.SemiTrust.DataObjectsCollection DataObjects { get; }

member this.DataObjects : Microsoft.Office.Interop.InfoPath.SemiTrust.DataObjectsCollection

Public ReadOnly Property DataObjects As DataObjectsCollection

Valor de propiedad

DataObjectsCollection

Implementaciones

DataObjects

Ejemplos

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

DataSourceObject myDataObject = 
   (DataSourceObject)thisXDocument.<span class="label">DataObjects</span>["CityList"];

Dim myDataObject As DataSourceObject = _
   DirectCast(thisXDocument.<span class="label">DataObjects</span>["CityList"], DataSourceObject)

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

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

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

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

DataSourceObject myDataObject = 
   (DataSourceObject)thisXDocument.<span class="label">DataObjects</span>["CityList"];

Dim myDataObject As DataSourceObject = _
   DirectCast(thisXDocument.<span class="label">DataObjects</span>["CityList"], DataSourceObject)

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

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

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

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 DataSourceObject objeto dentro de la colección DataObjects .

Importante: Solo se puede acceder a este miembro mediante formularios que se ejecutan en el mismo dominio que el formulario abierto actualmente o mediante formularios a los que se han concedido permisos entre dominios.