【C#】C#のdatagridviewにSQL Serverのテーブルデータとチェックボックスを表示させるには

この記事では、C#のdatagridviewにSQL Serverのテーブルデータとチェックボックスを表示させる方法についてご説明します。

すぐにソースコードを見たい場合はこちらをクリック

Table of Contents

【動画】C#のdatagridviewにSQL Serverのテーブルデータとチェックボックスを表示させる実際の動き

本題に入る前に、まずは次の動画をご覧ください。

SqlConnectionインスタンスを生成し、SQL Serverのデータベースに接続するのに必要な接続文字列を参照してSQL Serverのデータベースに接続します。

SQL Serverのデータベースに接続したら、SQLのSELECT文を実行してテーブルデータを取得します。

取得したテーブルデータをデータテーブルに格納してDataGridViewにデータを表示します。

datagridviewにデータを表示したら、チェックボックスを表示する列を追加します。

コードの流れ

STEP.1

SQL Serverのデータベースに接続するのに必要な接続文字列を用意する

SQL Serverのデータベースに接続するのに必要な接続文字列を用意します。

STEP.2

STEP.1で用意した接続文字列を元に、SqlConnectionオブジェクトを作成する

STEP.1で用意した接続文字列を元に、SqlConnectionオブジェクトを作成します。

STEP.3

SqlConnectionオブジェクトのOpenメソッドを実行してSQL Serverのデータベースに接続する

SqlConnectionオブジェクトのOpenメソッドを実行してSQL Serverのデータベースに接続します。

STEP.4

SQLのSELECT文を実行してテーブルデータを取得する

SQLのSELECT文を実行してテーブルデータを取得します。

STEP.5

STEP.4で取得したSQL Serverのテーブルデータをデータテーブル(DataTable)に格納する

STEP.4で取得したSQL Serverのテーブルデータをデータテーブル(DataTable)に格納します。

STEP.6

データテーブル(DataTable)に格納したSQL ServerのテーブルデータをDataGridViewにデータを表示する

データテーブル(DataTable)に格納したSQL ServerのテーブルデータをDataGridViewにデータを表示します。

STEP.7

チェックボックスを表示する列を追加する

チェックボックスを表示する列を追加します。

目次へ戻る

フォームとSQL Serverのテーブルデータの例

今回は次のフォームとSQL Serverのテーブルデータを用意しました。

フォーム上には処理を開始する実行チェックボックスとSQL Serverのテーブルデータとチェックボックスを表示させるdataGridViewが設置されています。

dataGridViewには、以上のSQL Serverのテーブルデータを表示させます。

以上のデータとチェックボックスを表示させた結果は下のとおりです。

目次へ戻る

C#のコード(例)

App.configのコード

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <startup> 
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7.2" />
    </startup>
    <appSettings>
        <!-- 接続文字列 -->
        <add key="DBConnString" value="Data Source=(LocalDB)\MSSQLLocalDB;Initial Catalog={0};Integrated Security=True" />

        <!-- SQL Serverのデータベース名 -->
        <add key="DBName" value="CS_01" />

    </appSettings>
</configuration>

注目すべきコード

フォームのコード

using System;
using System.Data.SqlClient;
using System.Windows.Forms;
using System.Configuration;

namespace wfcs_0080
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e)
        {
            // App.configのappSettingsタグ内に記述した「DBConnString」のキーの値を取得して変数「connStrTemplate」に格納する
            string connStrTemplate = ConfigurationManager.AppSettings["DBConnString"];

            // App.configのappSettingsタグ内に記述した「DBName」のキーの値を取得して変数「dbPathStr」に格納する
            string dbPathStr = ConfigurationManager.AppSettings["DBName"];

            // connStrTemplateの{0}の部分を、「dbPathStr」の値に置き換える
            string connectionString = string.Format(connStrTemplate, dbPathStr);

            // SqlConnectionインスタンスを生成する
            using (var connection = new SqlConnection(connectionString))
            {
                // SELECT文を用意する
                string commandText = "SELECT person FROM tbl_test";

                // SqlCommandインスタンスを生成する
                var command = new SqlCommand(commandText, connection);

                // SQL Serverのデータベースファイルを開く
                connection.Open();

                // SELECT文を実行し、結果をSqlDataReaderのインスタンスに格納する
                using (var reader = command.ExecuteReader())
                {
                    // 取得したデータの最終行まで処理を繰り返すwhileループ
                    while (reader.Read())
                    {
                        // 値をコンボボックスに追加する(フィールド名が「person」の値)
                        comboBox1.Items.Add(reader["person"].ToString());
                    }
                }
            }
        }
    }
}

注目すべきコード①

最初に見て頂きたいのは5行目です。

using System.Data.SqlClient;

コードの説明

以上のコードは、「System.Data.SqlClient」はSqlConnectionクラスを使うのに必要な名前空間です。

SqlConnectionクラスからインスタンスを生成し、SqlConnectionインスタンスのOpenメソッドを実行することでSQL Serverのデータベースに接続することができます。

注目すべきコード②

次に見て頂きたいのは19行目から22行目です。

            // DataGridViewのデータソースをnullに設定して表示されているデータをクリアする
            dataGridView1.DataSource = null;

            // DataGridViewの列をクリアして表示されている列を削除する
            dataGridView1.Columns.Clear();

コードの説明

以上のコードは、datagridviewの表示をクリアする処理のコードです。

19行目でDataSourceにnullを設定することで表示されているデータをクリアし、22行目のClearメソッドを実行することで表示されている列を削除します。

以上の2行のコードを実行することでdatagridviewの表示がクリアされます。

注目すべきコード③

次に見て頂きたいのは25行目から28行目です。

            // App.configのappSettingsタグ内に記述した「DBConnString」のキーの値を取得して変数「connStrTemplate」に格納する
            string connStrTemplate = ConfigurationManager.AppSettings["DBConnString"];

            // App.configのappSettingsタグ内に記述した「DBName」のキーの値を取得して変数「dbPathStr」に格納する
            string dbPathStr = ConfigurationManager.AppSettings["DBName"];

コードの説明

以上のコードは、App.configのappSettingsタグ内に記述した「DBConnString」「DBName」のキーの値を取得して変数に格納するコードです。

「DBConnString」のキーの値は変数「connStrTemplate」に、「DBName」のキーの値は変数「DBName」に格納します。

注目すべきコード④

次に見て頂きたいのは25行目です。

            // connStrTemplateの{0}の部分を、「dbPathStr」の値に置き換える
            string connectionString = string.Format(connStrTemplate, dbPathStr);

コードの説明

以上のコードは、connStrTemplateの{0}の部分を、「DBName」の値に置き換える処理のコードです。

connStrTemplateの{0}の部分を、「DBName」の値に置き換える、とはどういうことかというと、{0}の部分をSQL Serverのデータベース名に置き換える、ということです。

今回は接続文字列と、SQL Serverのデータベース名を分けてそれぞれ「DBConnString」と「DBName」とキーを分けてあるので、フォームのコード側で接続文字列と、SQL Serverのデータベース名を一つの文字列に組み立てています。

参考までに、string.Format実行前と実行後の状態を以下にお見せします。

以上のように、{0}の部分が「CS_01」に置き換わっています。

参考：string.Format実行前

“Data Source=(LocalDB)\\MSSQLLocalDB;Initial Catalog={0};Integrated Security=True”

参考：string.Format実行後

“Data Source=(LocalDB)\\MSSQLLocalDB;Initial Catalog=CS_01;Integrated Security=True”

注目すべきコード⑤

次に見て頂きたいのは34行目から37行目です。

            // SqlConnectionインスタンスを生成する
            using (SqlConnection connection = new SqlConnection(connectionString))
            {
                // SQL Serverのデータベースに接続する
                connection.Open();

コードの説明

以上のコードは、SqlConnectionインスタンスを作成し、SQL Serverのデータベースファイル接続している処理のコードです。

コードの詳細

34行目のコードでは、App.configから取得したSQL Serverのデータベースの接続情報(connectionString)を元にSqlConnectionインスタンスを作成しています。

37行目のコードでは、生成したSqlConnectionインスタンスのOpenメソッドを実行してSQL Serverのデータベースに接続しています。

注目すべきコード⑥

次に見て頂きたいのは40行目から60行目です。

                // SELECT文を用意する
                string query = "SELECT * FROM tbl_test";

                // SqlCommandインスタンスを生成する
                using (SqlCommand command = new SqlCommand(query, connection))
                {
                    // SqlDataAdapterインスタンスを生成する
                    using (SqlDataAdapter adapter = new SqlDataAdapter(command))
                    {
                        // DataTableインスタンスを生成する
                        DataTable dt = new DataTable();

                        // データテーブルにデータを格納する
                        adapter.Fill(dt);

                        // DataGridViewにデータを表示する
                        this.dataGridView1.DataSource = dt;
                    }
                }

                // SQL Serverのデータベースの接続を閉じる
                connection.Close();

コードの説明

以上のコードは、SQL Serverのテーブルデータを取得するSELECT文を用意して実行し、取得したSQL ServerのテーブルデータをdataGridViewに表示する処理のコードです。

続けてSQL Serverのデータベースの接続を閉じています。

コードの詳細

40行目のコードでは、SQL Serverのテーブルデータを取得するSELECT文を用意しています。

43行目のコードでは、SELECT文を実行するために、SELECT文とSqlCommandインスタンス(command)を指定してSqlCommandクラスからインスタンスを生成します。

46行目のコードでは、SqlDataAdapterインスタンスを生成し、SELECT文を関連付けます。

SqlDataAdapterインスタンスが生成されたことで、SELECT文を実行することができるようになります。

49行目のコードでは、SELECT文を実行して取得したデータを格納するのに必要なDataTableのインスタンス「dt」を生成します。

52行目のコードでは、Fillメソッドを実行するとSELECT文が実行されて、取得したデータが「dt」に格納されます。

55行目のコードでは、取得したSQL ServerのテーブルデータをdataGridViewに表示させます。

60行目のコードでは、SQL Serverのデータベースファイルの接続を閉じています。

注目すべきコード⑦

次に見て頂きたいのは64行目から73行目です。

            // DataGridViewCheckBoxColumnのインスタンスを生成する
            DataGridViewCheckBoxColumn column = new DataGridViewCheckBoxColumn();

            // 列のヘッダの名前に「チェック」の文字列を設定する
            column.Name = "チェック";

            // dataGridViewにチェックボックスの列を追加する
            dataGridView1.Columns.Add(column);

            // チェックボックスの列の表示位置を列の1列目(インデックスが0)に設定する
            dataGridView1.Columns["チェック"].DisplayIndex = 0;

コードの説明

以上のコードは、チェックボックスを表示する列を追加する処理のコードです。

コードの詳細

64行目のコードは、DataGridViewにチェックボックス型のカラムを追加するためDataGridViewCheckBoxColumnのインスタンスの生成を行います。

DataGridViewCheckBoxColumnのインスタンスを生成することで、特定のセルにチェックボックスを持つ列をDataGridViewに追加することができます。

67行目のコードは、列のヘッダの名前に「チェック」の文字列を設定します。