BindingSource.DataSource Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Datenquelle ab, an die der Connector gebunden ist, oder legt sie fest.
public:
property System::Object ^ DataSource { System::Object ^ get(); void set(System::Object ^ value); };
public object DataSource { get; set; }
public object? DataSource { get; set; }
member this.DataSource : obj with get, set
Public Property DataSource As Object
Eigenschaftswert
Eine Object , die als Datenquelle fungiert. Der Standardwert lautet null.
Beispiele
Im folgenden Codebeispiel wird der DataSourceBindingSource Komponente eine Liste von Kunden zugewiesen. Dieses Codebeispiel ist Teil eines größeren Beispiels unter 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. Die resultierende Datenquelle wird als Liste verfügbar gemacht. In der folgenden Tabelle sind einige der allgemeinen Datenquellen und die resultierende Listenauswertung aufgeführt.
| DataSource-Eigenschaft | Ergebnisse auflisten |
|---|---|
null |
Eine Leere IBindingList von Objekten. Durch 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. |
| Nicht-Listentyp oder Objekt vom Typ "T" | Leer IBindingList vom Typ "T". |
| Arrayinstanz | IBindingList enthält die Arrayelemente. |
| IEnumerable Instanz | Ein IBindingList Element, das die IEnumerable Elemente enthält. |
| Listeninstanz mit dem Typ "T" | IBindingList Instanz, die den Typ "T" enthält. |
Darüber hinaus können sie auf andere Listentypen festgelegt werden, DataSource z IListSource . B. und ITypedList die BindingSource Entsprechenden behandeln. In diesem Fall sollte der in der Liste enthaltene Typ über einen parameterlosen Konstruktor verfügen.
Wenn sie eine Datenquelle festlegen, wenn der angegebene Verweis mehr als eine Liste oder Tabelle enthält, müssen Sie die DataMember Eigenschaft auf eine Zeichenfolge festlegen, die die zu bindende Liste angibt. Durch Festlegen dieser Eigenschaft wird das DataSourceChanged Ereignis ausgelöst.
Hinweis
Wenn Sie Änderungen am DataSource Eigenschaftswert vornehmen, sollten Sie dies im Ui-Thread (Ui) tun, um sicherzustellen, dass die Benutzeroberfläche die Änderungen widerspiegelt.
Die DataSource Eigenschaft ist die Standardeigenschaft für die BindingSource Klasse.