BindingSource.DataSource BindingSource.DataSource BindingSource.DataSource BindingSource.DataSource Property

定義

コネクタのバインド先であるデータ ソースを取得または設定します。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

プロパティ値

データ ソースとして機能する ObjectAn Object that acts as a data source. 既定値は、null です。The default is null.

次のコード例では、 DataSource顧客のリストをBindingSourceコンポーネントのに割り当てます。The following code example assigns a list of customers to the DataSource of a BindingSource component. このコード例は、次の方法で提供される大規模な例の一部です。BindingSource のリセットメソッドを使用して変更通知を発生させます。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

注釈

プロパティDataSourceは、型、オブジェクト、型のリストなど、いくつかのデータソースに設定できます。The DataSource property can be set to a number of data sources, including types, objects, and lists of types. 結果として得られるデータソースはリストとして公開されます。The resulting data source will be exposed as a list. 次の表は、いくつかの一般的なデータソースと結果の一覧の評価を示しています。The following table shows some of the common data sources and the resulting list evaluation.

DataSource プロパティDataSource property 結果の一覧表示List results
null オブジェクトのIBindingList空の。An empty IBindingList of objects. 項目を追加すると、追加した項目の種類にリストが設定されます。Adding an item sets the list to the type of the added item.
nullDataMember設定null with DataMember set サポートされてArgumentExceptionいません。が発生します。Not supported, raises ArgumentException.
非リスト型または型 "T" のオブジェクトNon-list type or object of type "T" IBindingList "T" は空です。Empty IBindingList of type "T".
配列インスタンスArray instance IBindingList配列要素を格納している。IBindingList containing the array elements.
IEnumerableinstanceIEnumerable instance 項目をIEnumerable格納している。 IBindingListAn IBindingList containing the IEnumerable items.
型 "T" を含むリストインスタンスList instance containing type "T" IBindingList型 "T" を含むインスタンス。IBindingList instance containing type "T".

さらに、 DataSourceはやIListSource ITypedList などBindingSourceの他の種類のリストにも設定でき、は適切に処理します。In addition, DataSource can be set to other list types such as IListSource and ITypedList and the BindingSource will handle them appropriately. この場合、リストに含まれる型には、パラメーターなしのコンストラクターが必要です。In this case, the type contained in the list should have a parameterless constructor.

データソースを設定するときに、指定した参照に複数のリストまたはテーブルが含まれDataMemberている場合は、バインド先のリストを指定する文字列にプロパティを設定する必要があります。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. このプロパティを設定するDataSourceChangedと、イベントが発生します。Setting this property raises the DataSourceChanged event.

注意

DataSourceプロパティ値に変更を加える場合は、ui に変更が反映されるように、ユーザーインターフェイス (ui) スレッドで実行する必要があります。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.

プロパティは、 BindingSourceクラスの既定のプロパティです。 DataSourceThe DataSource property is the default property for the BindingSource class.

適用対象

こちらもご覧ください