XmlForm.DataSources Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene el DataSourceCollection objeto asociado al formulario.
public:
abstract property Microsoft::Office::InfoPath::DataSourceCollection ^ DataSources { Microsoft::Office::InfoPath::DataSourceCollection ^ get(); };
public abstract Microsoft.Office.InfoPath.DataSourceCollection DataSources { get; }
member this.DataSources : Microsoft.Office.InfoPath.DataSourceCollection
Public MustOverride ReadOnly Property DataSources As DataSourceCollection
Valor de propiedad
que DataSourceCollection contiene los DataSource objetos asociados al formulario.
Ejemplos
En el siguiente ejemplo de código, la propiedad DataSources de la XmlForm clase 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
Comentarios
El objeto DataSourceCollection contiene una colección de objetos que representan todos los orígenes de DataSource 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. Esto significa que los desarrolladores tendrán dos maneras de devolver el objeto DataSource que representa el origen de datos principal: mediante DataSources[""] o mediante la MainDataSource propiedad .
Ú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.