BindingSource.DataSource Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de gegevensbron op waaraan de connector is gekoppeld, op of stelt u deze in.
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
Waarde van eigenschap
Een Object die fungeert als een gegevensbron. De standaardwaarde is null.
Voorbeelden
In het volgende codevoorbeeld wordt een lijst met klanten toegewezen aan een DataSourceBindingSource onderdeel. Dit codevoorbeeld maakt deel uit van een groter voorbeeld in 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
Opmerkingen
De DataSource eigenschap kan worden ingesteld op een aantal gegevensbronnen, waaronder typen, objecten en lijsten met typen. De resulterende gegevensbron wordt weergegeven als een lijst. In de volgende tabel ziet u enkele algemene gegevensbronnen en de resulterende lijstevaluatie.
| Eigenschap DataSource | Lijst met resultaten |
|---|---|
null |
Een lege IBindingList verzameling van objecten. Als u een item toevoegt, wordt de lijst ingesteld op het type toegevoegd item. |
null met DataMember ingesteld |
Niet ondersteund, verhoogt ArgumentException. |
| Niet-lijsttype of object van het type 'T' | Leeg IBindingList van het type 'T'. |
| Matrixexemplaren | IBindingList met de matrixelementen. |
| IEnumerable voorbeeld | Een IBindingList met de IEnumerable items. |
| Lijstexemplaren met het type 'T' | IBindingList exemplaar met het type T. |
Bovendien DataSource kan worden ingesteld op andere lijsttypen, zoals IListSource en ITypedList de BindingSource juiste verwerking ervan. In dit geval moet het type in de lijst een parameterloze constructor hebben.
Wanneer u een gegevensbron instelt en de opgegeven verwijzing meer dan één lijst of tabel bevat, moet u de DataMember eigenschap instellen op een tekenreeks waarmee de lijst moet worden verbonden. Als u deze eigenschap instelt, wordt de DataSourceChanged gebeurtenis gegenereerd.
Note
Als u wijzigingen aanbrengt in de DataSource eigenschapswaarde, moet u dit doen op de gebruikersinterfacethread om ervoor te zorgen dat de gebruikersinterface de wijzigingen weerspiegelt.
De DataSource eigenschap is de standaardeigenschap voor de BindingSource klasse.