de la propiedad XmlForm.DataSources
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
Get
'Uso
Dim instance As XmlForm
Dim value As DataSourceCollection
value = instance.DataSources
public abstract DataSourceCollection DataSources { get; }
Valor de propiedad
Tipo: Microsoft.Office.InfoPath.DataSourceCollection
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 DataSources[""] o utilizando la propiedad MainDataSource.
Ú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.
Se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler o en un explorador web.
Ejemplos
En el siguiente ejemplo de código, la propiedad DataSources de la clase XmlForm se usa 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 de código, 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