XmlForm.DataSources-Eigenschaft

Artikel
04/27/2010

Ruft das dem Formular zugeordnete DataSourceCollection-Objekt ab.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

Public MustOverride ReadOnly Property DataSources As DataSourceCollection

Dim instance As XmlForm
Dim value As DataSourceCollection

value = instance.DataSources

public abstract DataSourceCollection DataSources { get; }

Eigenschaftswert

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 DataSourceCollection[""] oder mit der MainDataSource-Eigenschaft.

Hinweis:
Die DataSources-Eigenschaft stellt ähnliche Funktionalität für die DataObjects-Eigenschaft des XDocument-Objekts im COM/Skript-Objektmodell sowie für die DataObjects-Eigenschaft der _XDocument2-Benutzeroberfläche des InfoPath 2003-kompatiblen Objektmodells mit verwaltetem Code bereit.

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 Office InfoPath 2007 oder einem Webbrowser geöffnet wurden.

Beispiel

Im folgenden Beispiel wird die DataSources-Eigenschaft der XmlForm-Klasse zum Festlegen eines Verweises auf die sekundäre Datenquelle "CityList" verwendet.

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

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

Im folgenden Beispiel, in dem ein Ereignishandler für das Steuerelement 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

Siehe auch

Referenz

XmlForm-Klasse
XmlForm-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über