XmlForm.DataSources (Propiedad)

Obtiene el objeto DataSourceCollection asociado al formulario.

Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en microsoft.office.infopath.dll)

Sintaxis

'Declaración
Public MustOverride ReadOnly Property DataSources As DataSourceCollection
'Uso
Dim instance As XmlForm
Dim value As DataSourceCollection

value = instance.DataSources

public abstract DataSourceCollection DataSources { get; }

Valor de propiedad

Objeto DataSourceCollection que contiene los objetos DataSource asociados al formulario.

Comentarios

El objeto DataSourceCollection contiene una colección de objetos DataSource que representan todos los orígenes de datos externos (secundarios) asociados a la plantilla de formulario. El objeto DataSourceCollection contiene también un objeto DataSource que representa el origen de datos principal del formulario. De esta forma, los programadores tendrán dos métodos para devolver el objeto DataSource que representa el origen de datos principal: utilizando DataSourceCollection[""] o utilizando la propiedad MainDataSource.

Nota

La propiedad DataSources proporciona una funcionalidad parecida a la de la propiedad DataObjects del objeto XDocument del modelo de objetos COM/Scripting, y a la de la propiedad DataObjects de la interfaz _XDocument2 del modelo de objetos de código administrado compatible con InfoPath 2003.

Sólo pueden tener acceso a este miembro los formularios que se ejecuten en el mismo dominio que el formulario abierto actualmente o los formularios a los que se hayan concedido permisos entre dominios.

Se puede tener acceso a este tipo o miembro desde un código ejecutado en formularios abiertos en Microsoft Office InfoPath 2007 o en un explorador Web.

Ejemplo

En el siguiente ejemplo, la propiedad DataSources de la clase XmlForm se utiliza para establecer una referencia al origen de datos secundario "CityList".

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

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

En el siguiente ejemplo, que implementa un controlador de eventos para un control Botón de un formulario, la propiedad DataSources del objeto XmlForm se usa para establecer una referencia a la colección DataSourceCollection del formulario. El código realiza una operación de bucle en la colección y muestra el índice de posición y el nombre de cada objeto DataSource que contiene.

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

Vea también

Referencia

XmlForm (Clase)
XmlForm (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)