XmlForm.DataSources-Eigenschaft
Ruft das dem Formular zugeordnete DataSourceCollection-Objekt ab.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride ReadOnly Property DataSources As DataSourceCollection
Get
'Usage
Dim instance As XmlForm
Dim value As DataSourceCollection
value = instance.DataSources
public abstract DataSourceCollection DataSources { get; }
Eigenschaftswert
Typ: Microsoft.Office.InfoPath.DataSourceCollection
Eine DataSourceCollection-Auflistung, in der alle dem Formular zugeordneten DataSource-Objekte enthalten sind.
Hinweise
Das DataSourceCollection-Objekt enthält eine Auflistung von DataSource-Objekten, die die der Formularvorlage zugeordneten externen (sekundären) Datenquellen darstellen. Darüber hinaus enthält das DataSourceCollection-Objekt ein DataSource-Objekt, das die Hauptdatenquelle des Formulars darstellt. Das bedeutet, dass Entwickler die Möglichkeit haben, das DataSource-Objekt, das die Hauptdatenquelle darstellt, auf zweierlei Arten zurückzugeben: mithilfe von DataSources[""] oder mit der MainDataSource-Eigenschaft.
Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.
Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft InfoPath Filler oder einem Webbrowser geöffnet wurden.
Beispiele
Im folgenden Codebeispiel wird die DataSources-Eigenschaft der XmlForm-Klasse verwendet, um einen Verweis auf die sekundäre Datenquelle "CityList" festzulegen.
DataSource myDataSource = this.DataSources["CityList"];
Dim myDataSource As DataSource = Me.DataSources("CityList")
Im folgenden Codebeispiel, in dem ein Ereignishandler für ein Steuerelement vom Typ Schaltfläche in einem Formular implementiert wird, wird die DataSources-Eigenschaft des XmlForm-Objekts verwendet, um einen Verweis auf die DataSourceCollection-Auflistung des Formulars festzulegen. Der Code durchläuft die Auflistung in einer Schleife und zeigt den positionellen Index sowie den Namen jedes in der Auflistung enthaltenen DataSource-Objekts an.
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