プロジェクトにデータソースを追加する

データ ソース構築ウィザードを使用してプロジェクトにデータソースを追加します。

1. ［プロジェクト］または［データ］メニューの［新しいデータ ソースの追加（N）］を選択します。
2. 「データ ソース構成ウィザード」が起動したら「データベース」を選択して〈次へ〉ボタンをクリックします。
3. 「データベース モデルの選択」画面で「データセット」を選択しして〈次へ〉ボタンをクリックします。
4. 「データ接続の選択」画面で〈新しい接続〉ボタンをクリックします。
5. 「接続の追加」ダイアログで、次のように選択し、［接続のテスト］ボタンを押して接続を確認します。
   • データ ソース： Microsoft Access データベース ファイル
   • データベース ファイル名： Sample.mdb
6. 〈OK〉ボタンをクリックします。
7. 「データ接続の選択」画面で〈次へ〉ボタンをクリックします。
8. プロジェクトへデータファイルをコピーするかどうかを確認するメッセージボックスが表示されたら〈はい〉をクリックします。
9. 「接続文字列をアプリケーション構成ファイルに保存する」画面で〈次へ〉ボタンをクリックします。
10. 「データベース オブジェクトの選択」画面で、「データセット内に指定するデータベース オブジェクト」から「会社」テーブルをチェックし、〈完了〉ボタンをクリックします。

DataSource プロパティを設定する

データベース内のデータをリストコントロールに表示する場合は、データベースから作成したDataSetをDataSource プロパティに設定します。
AutoGenerateColumns プロパティがTrueに設定されていると、リストコントロールは、DataSouceを設定するだけで自動的にカラムが生成されてデータが接続されます。

前項のようにプロパティを設定するほかに、データソースウィンドウからドラッグ＆ドロップして簡単にデータに接続したコントロールを貼り付けることもできます。

1. 「データソース」ウィンドウを開き新しいデータソースを追加します。ここでは、製品付属のSample.mdbの「コンボ」テーブルを追加したと仮定し説明します。
   
2. 「データソース」ウィンドウに「コンボ」テーブルが追加されたことを確認します。
3. 「コンボ」のドロップダウンメニューから [GcListBox] を選択します。
   
   
   [GcListBox] がメニューに表示されない場合、[カスタマイズ] で表示されるダイアログで「GcListBox」を有効にします。
4. 「データソース」ウィンドウから「コンボ 」をフォームにドラッグ＆ドロップします。
5. コンボテーブルに接続したリストコントロールがフォームに貼り付けられます。

以下は、コーディングでデータベースの内容をリストコントロールに表示する例です。

Imports System.Data.OleDb
Imports GrapeCity.Win.Editors

' DataSet オブジェクトを作成します。
Friend aConn As OleDbConnection = New OleDbConnection( _
    "Provider=Microsoft.Jet.OLEDB.4.0;" _
    + "Data Source= C:\Program Files\InputManWin8\Data\Sample.mdb;")
Friend aDA As OleDbDataAdapter = New OleDbDataAdapter( _
    "SELECT * FROM [会社]", aConn)
Friend aDS As DataSet = New DataSet()
aDA.Fill(aDS)

' DataSet オブジェクトをDataSource プロパティに設定します。
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
    ' DataSet オブジェクトを設定します。
    GcListBox1.DataSource = aDS.Tables(0)
End Sub

using System.Data.OleDb;
using GrapeCity.Win.Editors;

// DataSet オブジェクトを作成します。
private OleDbConnection aConn = new OleDbConnection(
    "Provider=Microsoft.Jet.OLEDB.4.0;"
    + "Data Source= C:\\Program Files\\InputManWin8\\Data\\Sample.mdb;");
private OleDbDataAdapter aDA  = new OleDbDataAdapter(
    "SELECT * FROM [会社]", aConn);
private DataSet aDS = new DataSet();
aDA.Fill(aDS);

// DataSet オブジェクトをDataSource プロパティに設定します。
private void button1_Click(object sender, System.EventArgs e)
{
    // DataSet オブジェクトを設定します。
    gcListBox1.DataSource = aDS.Tables[0];
}

特定フィールドのデータのみ表示する場合は、AutoGenerateColumns プロパティをFalseに設定します。カラムを追加し、バインドするデータのプロパティ名をListColumn クラスのDataPropertyName プロパティで設定します。

カラムを追加する方法については「カラムの設定」を参照してください。

次のサンプルコードでは、前項で接続したデータソース（会社テーブル）の特定のデータをリストコントロールのドロップダウンリストに表示する例を示します。

' 自動カラム生成を禁止し、データソースに接続します。
GcListBox1.AutoGenerateColumns = False
GcListBox1.DataSource = Me.会社BindingSource

' カラムを作成します。
Dim lc1 As New GrapeCity.Win.Editors.ListColumn("会社名")
lc1.DataPropertyName = "会社名"
Dim lc2 As New GrapeCity.Win.Editors.ListColumn("電話番号")
lc2.DataPropertyName = "ＴＥＬ"

' リストコントロールにカラムを追加します。
GcListBox1.ListColumns.Add(lc1)
GcListBox1.ListColumns.Add(lc2)

// 自動カラム生成を禁止し、データソースに接続します。
gcListBox1.AutoGenerateColumns = false;
gcListBox1.DataSource = this.会社BindingSource;

// カラムを作成します。
GrapeCity.Win.Editors.ListColumn lc1 = new GrapeCity.Win.Editors.ListColumn("会社名");
lc1.DataPropertyName = "会社名";
GrapeCity.Win.Editors.ListColumn lc2 = new GrapeCity.Win.Editors.ListColumn("電話番号");
lc2.DataPropertyName = "ＴＥＬ";

// リストコントロールにカラムを追加します。
gcListBox1.Columns.Add(lc1);
gcListBox1.Columns.Add(lc2);