BindingSource.DataSource Eigenschaft

Definition

Ruft die Datenquelle ab, mit der eine Bindung besteht, oder legt diese fest.Gets or sets the data source that the connector binds to.

public:
 property System::Object ^ DataSource { System::Object ^ get(); void set(System::Object ^ value); };
public object DataSource { get; set; }
member this.DataSource : obj with get, set
Public Property DataSource As Object

Eigenschaftswert

Ein Object, das als Datenquelle fungiert.An Object that acts as a data source. Der Standardwert ist null.The default is null.

Beispiele

Im folgenden Codebeispiel wird der DataSource einer BindingSource Komponente eine Liste von Kunden zugewiesen.The following code example assigns a list of customers to the DataSource of a BindingSource component. Dieses Codebeispiel ist Teil eines größeren Beispiels, das unter Gewusst wie: Aufrufen von Änderungs Benachrichtigungen mithilfe der BindingSource ResetItem-Methodebereitgestellt wird.This code example is part of a larger example provided at How to: Raise Change Notifications Using the BindingSource ResetItem Method.

void Form1_Load( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   // Create and populate the list of DemoCustomer objects
   // which will supply data to the DataGridView.
   List< DemoCustomer^ >^ customerList = gcnew List< DemoCustomer^ >;
   customerList->Add( DemoCustomer::CreateNewCustomer() );
   customerList->Add( DemoCustomer::CreateNewCustomer() );
   customerList->Add( DemoCustomer::CreateNewCustomer() );
   
   // Bind the list to the BindingSource.
   this->customersBindingSource->DataSource = customerList;
   
   // Attach the BindingSource to the DataGridView.
   this->customersDataGridView->DataSource =
      this->customersBindingSource;
}
private void Form1_Load(System.Object sender, System.EventArgs e)
{
    // Create and populate the list of DemoCustomer objects
    // which will supply data to the DataGridView.
    List<DemoCustomer> customerList = new List<DemoCustomer>();
    customerList.Add(DemoCustomer.CreateNewCustomer());
    customerList.Add(DemoCustomer.CreateNewCustomer());
    customerList.Add(DemoCustomer.CreateNewCustomer());

    // Bind the list to the BindingSource.
    this.customersBindingSource.DataSource = customerList;

    // Attach the BindingSource to the DataGridView.
    this.customersDataGridView.DataSource = 
        this.customersBindingSource;
}
Private Sub Form1_Load(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Me.Load
    ' Create and populate the list of DemoCustomer objects
    ' which will supply data to the DataGridView.
    Dim customerList As List(Of DemoCustomer) = _
    New List(Of DemoCustomer)
    customerList.Add(DemoCustomer.CreateNewCustomer())
    customerList.Add(DemoCustomer.CreateNewCustomer())
    customerList.Add(DemoCustomer.CreateNewCustomer())

    ' Bind the list to the BindingSource.
    Me.customersBindingSource.DataSource = customerList

    ' Attach the BindingSource to the DataGridView.
    Me.customersDataGridView.DataSource = Me.customersBindingSource
End Sub

Hinweise

Die DataSource-Eigenschaft kann auf eine Reihe von Datenquellen festgelegt werden, einschließlich Typen, Objekte und Listen von Typen.The DataSource property can be set to a number of data sources, including types, objects, and lists of types. Die resultierende Datenquelle wird als Liste verfügbar gemacht.The resulting data source will be exposed as a list. In der folgenden Tabelle sind einige der allgemeinen Datenquellen und die resultierende Listen Auswertung aufgeführt.The following table shows some of the common data sources and the resulting list evaluation.

DataSource-EigenschaftDataSource property Ergebnisse auflistenList results
null Eine leere IBindingList von-Objekten.An empty IBindingList of objects. Durch das Hinzufügen eines Elements wird die Liste auf den Typ des hinzugefügten Elements festgelegt.Adding an item sets the list to the type of the added item.
null mit DataMember Satznull with DataMember set Nicht unterstützt, löst ArgumentExceptionaus.Not supported, raises ArgumentException.
Non-List-Typ oder-Objekt vom Typ "T"Non-list type or object of type "T" Leere IBindingList vom Typ "t".Empty IBindingList of type "T".
Array InstanzArray instance IBindingList, das die Array Elemente enthält.IBindingList containing the array elements.
IEnumerable InstanzIEnumerable instance Ein-IBindingList, der die IEnumerable Elemente enthält.An IBindingList containing the IEnumerable items.
Listen Instanz mit dem Typ "T"List instance containing type "T" IBindingList-Instanz, die den Typ "t" enthält.IBindingList instance containing type "T".

Außerdem können DataSource auf andere Listen Typen festgelegt werden, z. b. IListSource und ITypedList, und der BindingSource verarbeitet sie entsprechend.In addition, DataSource can be set to other list types such as IListSource and ITypedList and the BindingSource will handle them appropriately. In diesem Fall sollte der in der Liste enthaltene Typ über einen Parameter losen Konstruktor verfügen.In this case, the type contained in the list should have a parameterless constructor.

Beim Festlegen einer Datenquelle müssen Sie die DataMember-Eigenschaft auf eine Zeichenfolge festlegen, die die Liste angibt, an die die Bindung erfolgen soll, wenn der angegebene Verweis mehr als eine Liste oder Tabelle enthält.When setting a data source, if the supplied reference contains more than one list or table, you must set the DataMember property to a string that specifies the list to bind to. Durch Festlegen dieser Eigenschaft wird das DataSourceChanged-Ereignis ausgelöst.Setting this property raises the DataSourceChanged event.

Hinweis

Wenn Sie Änderungen am DataSource-Eigenschafts Wert vornehmen, sollten Sie dies im Benutzeroberflächen Thread durchführen, um sicherzustellen, dass die Benutzeroberfläche die Änderungen widerspiegelt.If you make any changes to the DataSource property value, you should do so on the user interface (UI) thread to ensure that the UI reflects the changes.

Die DataSource-Eigenschaft ist die Standard Eigenschaft für die BindingSource-Klasse.The DataSource property is the default property for the BindingSource class.

Gilt für:

Siehe auch