BindingSource.DataSource Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die Datenquelle ab, mit der eine Bindung besteht, oder legt diese fest.

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

Object

Ein Object, das als Datenquelle fungiert. Der Standardwert ist null.

Beispiele

Im folgenden Codebeispiel wird einer Komponente eine BindingSource Liste von Kunden zugewiesenDataSource. Dieses Codebeispiel ist Teil eines größeren Beispiels unter Vorgehensweise: Auslösen von Änderungsbenachrichtigungen mithilfe der BindingSource ResetItem-Methode.

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, Objekten und Typenlisten. Die resultierende Datenquelle wird als Liste verfügbar gemacht. In der folgenden Tabelle sind einige der gängigen Datenquellen und die resultierende Listenauswertung aufgeführt:

DataSource-Eigenschaft	Listenergebnisse
null	Ein leeres IBindingList-Element für Objekte. Nach dem Hinzufügen eines Elements wird die Liste auf den Typ des hinzugefügten Elements festgelegt.
null mit DataMember set	Wird nicht unterstützt, löst aus ArgumentException.
Listenfremder Typ oder Objekt vom Typ „T“	Leer IBindingList des Typs "T".
Arrayinstanz	IBindingList enthält die Arrayelemente.
IEnumerable-Instanz	Ein IBindingList , das die IEnumerable Elemente enthält.
Listeninstanz mit dem Typ „T“	IBindingListinstance, die den Typ "T" enthalten.

Darüber hinaus kann auf andere Listentypen wie IListSource und ITypedList festgelegt werden, DataSource und die BindingSource behandelt sie entsprechend. In diesem Fall sollte der in der Liste enthaltene Typ über einen parameterlosen Konstruktor verfügen.

Wenn der angegebene Verweis mehr als eine Liste oder Tabelle enthält, müssen Sie beim Festlegen einer Datenquelle die DataMember Eigenschaft auf eine Zeichenfolge festlegen, die die Liste angibt, an die gebunden werden soll. Durch Festlegen dieser Eigenschaft wird das DataSourceChanged Ereignis ausgelöst.

Hinweis

Wenn Sie Änderungen am Eigenschaftswert vornehmen, sollten Sie dies DataSource im Thread der Benutzeroberfläche (UI) tun, um sicherzustellen, dass die Benutzeroberfläche die Änderungen widerspiegelt.

Die DataSource -Eigenschaft ist die Standardeigenschaft für die BindingSource -Klasse.

Weitere Informationen

• DataMember
• IList
• IListSource