XmlForm.DataSources Eigenschaft

Definition

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Ruft das DataSourceCollection -Objekt ab, das dem Formular zugeordnet ist.

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

Eigenschaftswert

DataSourceCollection

Eine DataSourceCollection , die alle DataSource dem Formular zugeordneten Objekte enthält.

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

Hinweise

Das DataSourceCollection-Objekt enthält eine Auflistung von DataSource -Objekten, die alle externen (sekundären) Datenquellen darstellen, die der Formularvorlage zugeordnet sind. Darüber hinaus enthält das DataSourceCollection-Objekt ein DataSource-Objekt, das die Hauptdatenquelle des Formulars darstellt. Dies bedeutet, dass Entwickler zwei Möglichkeiten haben, das DataSource-Objekt zurückzugeben, das die Standard Datenquelle darstellt: mithilfe von DataSources[""] oder mithilfe der MainDataSource -Eigenschaft.

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.