C# データベース接続:SQL Server への接続方法 (例)

データベースからデータにアクセスすることは、プログラミング言語の重要な側面の 1 つです。どのプログラミング言語でも、データベースを操作できることは絶対に必要です。 C# も例外ではありません。

さまざまな種類のデータベースで動作します。 Oracle や Microsoft SQL Server などの最も一般的なデータベースで動作します。

また、MongoDB や MySQL などの新しい形式のデータベースでも動作します。

この C# SQL 接続チュートリアルでは、次のことを学びます-

データベース接続の基礎
C# をデータベースに接続する方法
SqlDataReader を使用してデータにアクセスする
C# データベースへの挿入
記録の更新
記録の削除
コントロールをデータに接続する
C# データグリッドビュー

データベース接続の基礎

C# と .Net は、Oracle と Microsoft SQL Server が最も一般的なデータベースの大部分で動作します。しかし、どのデータベースでも、それらすべてを操作する背後にあるロジックはほとんど同じです。

この例では、Microsoft SQL Server をデータベースとして使用する方法を見ていきます。学習目的で、Microsoft SQL Server Express Edition をダウンロードして使用できます

データベースを操作する上で、すべてのデータベースに共通する概念は次のとおりです。

<オール>

つながり – データベース内のデータを操作するための最初の明らかなステップは、接続です。データベースへの接続は通常、以下のパラメーターで構成されます。

データベース名またはデータソース – 最初の重要なパラメーターは、接続を確立する必要があるデータベース名です。各接続は、一度に 1 つのデータベースでのみ機能します。
資格 – 次に重要な側面は、データベースへの接続を確立するために使用する必要があるユーザー名とパスワードです。これにより、ユーザー名とパスワードがデータベースへの接続に必要な権限を持っていることが保証されます。
オプションのパラメータ – データベースの種類ごとに、オプションのパラメーターを指定して、.net がデータベースへの接続を処理する方法に関する詳細情報を提供できます。たとえば、接続がアクティブである期間のパラメータを指定できます。特定の期間操作が実行されない場合、パラメーターは接続を閉じる必要があるかどうかを決定します。

データベースからのデータの選択 – 接続が確立されたら、次の重要な側面は、データベースからデータをフェッチすることです。 C# は、データベースに対して「SQL」選択コマンドを実行できます。「SQL」ステートメントを使用して、データベース内の特定のテーブルからデータを取得できます。

データベースへのデータの挿入 – C# を使用してデータベースにレコードを挿入することもできます。データベースに挿入する必要がある行ごとに C# で値を指定できます。

データベースへのデータの更新 – C# を使用して、既存のレコードをデータベースに更新することもできます。データベースに更新する必要がある行ごとに、C# で新しい値を指定できます。

データベースからのデータの削除 – C# を使用して、データベースからレコードを削除することもできます。削除する必要がある行を指定する選択コマンドは、C# で指定できます。

各操作の理論を確認したので、次のセクションに進んで、C# でデータベース操作を実行する方法を見てみましょう。

C# の SQL コマンド

C# の SqlCommand ユーザーがコマンドをクエリしてデータベースに送信できるようにします。 SQL コマンドは、SQL 接続オブジェクトによって指定されます。 2 つのメソッドが使用されます。クエリの結果には ExecuteReader メソッドが使用され、挿入、更新、および削除コマンドには ExecuteNonQuery が使用されます。これは、さまざまなコマンドに最適な方法です。

C# をデータベースに接続する方法

次に、データベースへの接続を作成するために保持する必要があるコードを見てみましょう。この例では、Demodb という名前のデータベースに接続します。データベースへの接続に使用される認証情報は以下のとおりです

ユーザー名 – sa
パスワード – demo123

データベースを操作する単純な Windows フォームアプリケーションが表示されます。データベースへの接続に使用される「接続」というシンプルなボタンがあります。

それでは、これを達成するために以下の手順に従いましょう

ステップ 1) 最初の手順では、Visual Studio で新しいプロジェクトを作成します。 Visual Studio を起動したら、メニューオプション [新規] → [プロジェクト] を選択する必要があります。

ステップ 2) 次の手順では、プロジェクトの種類を Windows フォームアプリケーションとして選択します。ここでは、プロジェクトの名前と場所についても言及する必要があります。

<オール>

プロジェクトダイアログボックスには、Visual Studio でさまざまな種類のプロジェクトを作成するためのさまざまなオプションが表示されます。左側の Windows オプションをクリックします。

前の手順で Windows オプションをクリックすると、Windows フォームアプリケーションのオプションが表示されます。このオプションをクリックします。

次に、アプリケーションに名前を付けます。この場合は「DemoApplication」です。また、アプリケーションを保存する場所も提供する必要があります。

最後に、[OK] ボタンをクリックして、Visual Studio でプロジェクトを作成します。

ステップ 3) 次に、ツールボックスから Windows フォームにボタンを追加します。 Button の text プロパティを Connect として配置します。こんな感じになります

ステップ 4) フォームをダブルクリックして、ボタンクリックイベントのコードにイベントハンドラーを追加します。イベントハンドラーで、以下のコードを追加します。

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Data.SqlClient;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;

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

  private void button1_Click(object sender, EventArgs e)
  {
   string connetionString;
   SqlConnection cnn;
   connetionString = @"Data Source=WIN-50GP30FGO75;Initial Catalog=Demodb;User ID=sa;Password=demol23";
   cnn = new SqlConnection(connetionString);
   cnn.Open();
   MessageBox.Show("Connection Open  !");
   cnn.Close();
  }
 }
}

コードの説明:-

<オール>

最初のステップは、接続文字列と SQL Server データベースへの接続を作成するために使用される変数を作成することです。

次のステップは、接続文字列を作成することです。 C# が接続文字列を理解するには、接続文字列を正しく指定する必要があります。接続文字列は次の部分で構成されます

データソース – これは、データベースが存在するサーバーの名前です。私たちの場合、それは WIN-50GP30FGO75 というマシン上にあります。
初期カタログは、データベースの名前を指定するために使用されます
UserID と Password は、データベースへの接続に必要な認証情報です。

次に、接続文字列を変数 cnn に割り当てます。 SqlConnection 型の変数 cnn は、データベースへの接続を確立するために使用されます。

次に、cnn 変数の Open メソッドを使用して、データベースへの接続を開きます。次に、接続が確立されたことを示すメッセージをユーザーに表示します。

操作が正常に完了したら、データベースへの接続を閉じます。データベースで他に何もする必要がない場合は、データベースへの接続を閉じることを常にお勧めします。

上記のコードを設定し、Visual Studio を使用してプロジェクトを実行すると、次の出力が得られます。フォームが表示されたら、[接続] ボタンをクリックします。

出力:-

「接続」ボタンをクリックすると、出力から、データベース接続が確立されたことがわかります。したがって、メッセージボックスが表示されました。

SqlDataReader を使用してデータにアクセス

C# を使用してデータにアクセスする方法を紹介するために、データベースに次のアーティファクトがあると仮定します。

<オール>

demotb というテーブル。このテーブルは、さまざまなチュートリアルの ID と名前を格納するために使用されます。

表には、「TutorialID」と呼ばれる列と「TutorialName」と呼ばれる列の 2 つの列があります。

当面、表は以下のように 2 行になります。

TutorialIDTutorialName1C#2ASP.Net

フォームのコードを変更して、このデータを照会し、メッセージボックスを介して情報を表示できるようにしましょう。以下に入力するすべてのコードは、前のセクションでデータ接続用に記述されたコードの続きであることに注意してください。

ステップ 1) ユーザーが理解しやすいように、コードを 2 つの部分に分割しましょう。

最初に、データベースからデータを読み取るために使用される「select」ステートメントを作成します。
次に、データベースに対して「select」ステートメントを実行し、それに応じてテーブルのすべての行をフェッチします。

コードの説明:-

<オール>

最初のステップは、次の変数を作成することです

SQLCommand – 「SQLCommand」は C# 内で定義されたクラスです。このクラスは、データベースへの読み取りおよび書き込み操作を実行するために使用されます。したがって、最初のステップは、このクラスの変数型を作成することです。この変数は、データベースからデータを読み取る後続のステップで使用されます。
DataReader オブジェクトは、SQL クエリで指定されたすべてのデータを取得するために使用されます。次に、データリーダーを使用して、テーブルのすべての行を 1 つずつ読み取ることができます。
次に、2 つの文字列変数を定義します。1 つは、SQL コマンド文字列を保持する「SQL」です。次は、すべてのテーブル値を含む「出力」です。

次のステップは、データベースに対して使用される SQL ステートメントを定義することです。私たちの場合は、「demotb から TutorialID、TutorialName を選択」です。これにより、テーブル demotb からすべての行が取得されます。

次に、データベースに対して SQL ステートメントを実行するために使用されるコマンドオブジェクトを作成します。 SQL コマンドでは、接続オブジェクトと SQL 文字列を渡す必要があります。

次に、demotb テーブルからすべての行を取得するデータリーダーコマンドを実行します。

テーブルのすべての行が揃ったので、行に 1 つずつアクセスするメカニズムが必要です。そのために、while ステートメントを使用します。 while ステートメントは、一度に 1 つずつデータリーダーから行にアクセスするために使用されます。次に、GetValue メソッドを使用して、TutorialID と TutorialName の値を取得します。

ステップ 2) 最後のステップでは、出力をユーザーに表示し、データベース操作に関連するすべてのオブジェクトを閉じます。

コードの説明:-

<オール>

MessageBox を使用して Output 変数の値を表示することにより、コードを続行します。出力変数には、demotb テーブルのすべての値が含まれます。

最後に、データベース操作に関連するすべてのオブジェクトを閉じます。これは常に良い習慣であることを忘れないでください。

上記のコードを設定し、Visual Studio を使用してプロジェクトを実行すると、次の出力が得られます。フォームが表示されたら、[接続] ボタンをクリックします。

出力:-

出力から、プログラムがデータベースから値を取得できたことを明確に確認できます。データはメッセージボックスに表示されます。

データベースへの C# の挿入

データへのアクセスと同様に、C# にはデータベースにレコードを挿入する機能もあります。データベースにレコードを挿入する方法を紹介するために、上で使用したのと同じテーブル構造を取り上げましょう。

TutorialIDTutorialName1C#2ASP.Net

次の行をテーブルに挿入できるように、フォームのコードを変更しましょう

TutorialIDTutorialName3VB.Net

それでは、次のコードをプログラムに追加しましょう。以下のコードスニペットは、データベースに既存のレコードを挿入するために使用されます。

コードの説明:-

<オール>

最初のステップは、次の変数を作成することです

SQLCommand – このデータ型は、データベースに対して SQL 操作を実行するために使用されるオブジェクトを定義するために使用されます。このオブジェクトは、SQL Server データベースに対して実行される SQL コマンドを保持します。
DataAdapter オブジェクトは、挿入、削除、更新コマンドなどの特定の SQL 操作を実行するために使用されます。
次に、SQL コマンド文字列を保持する「SQL」という文字列変数を定義します。

次のステップは、データベースに対して使用される SQL ステートメントを実際に定義することです。私たちの場合、TutorialID=1 と TutorialName=VB.Net のレコードを挿入する挿入ステートメントを発行しています

次に、データベースに対して SQL ステートメントを実行するために使用されるコマンドオブジェクトを作成します。 SQL コマンドでは、接続オブジェクトと SQL 文字列を渡す必要があります

データアダプタコマンドで、insert SQL コマンドをアダプタに関連付けます。次に、データベースに対して Insert ステートメントを実行するために使用される ExecuteNonQuery メソッドも発行します。「ExecuteNonQuery」メソッドは、データベースに対して DML ステートメントを発行するために C# で使用されます。 DML ステートメントとは、挿入、削除、および更新操作を意味します。 C# でテーブルに対してこれらのステートメントを発行する場合は、ExecuteNonQuery メソッドを使用する必要があります。

最後に、データベース操作に関連するすべてのオブジェクトを閉じます。これは常に良い習慣であることを忘れないでください。

出力:-

SQL Server Express に移動して demotb テーブルの行を確認すると、以下に示すように行が挿入されていることがわかります

C# 更新データベース

データへのアクセスと同様に、C# にはデータベースから既存のレコードを更新する機能もあります。レコードをデータベースに更新する方法を紹介するために、上で使用したのと同じテーブル構造を取り上げましょう。

TutorialIDTutorialName1C#2ASP.Net3VB.Net

次の行を更新できるように、フォームのコードを変更しましょう。古い行の値は、TutorialID が「3」で、Tutorial Name が「VB.Net」です。これを「VB.Net complete」に更新しますが、チュートリアル ID の行の値は同じままです。

古い行

TutorialIDTutorialName3VB.Net

新しい行

TutorialIDTutorialName3VB.Net 完了

それでは、次のコードをプログラムに追加しましょう。以下のコードスニペットは、データベース内の既存のレコードを更新するために使用されます。

C# SqlCommand の例とコードの説明:-

<オール>

最初のステップは、次の変数を作成することです

SQLCommand – このデータ型は、データベースに対して SQL 操作を実行するために使用されるオブジェクトを定義するために使用されます。このオブジェクトは、SQL Server データベースに対して実行される SQL コマンドを保持します。
dataadapter オブジェクトは、挿入、削除、更新コマンドなどの特定の SQL 操作を実行するために使用されます。
次に、SQL コマンド文字列を保持する SQL である文字列変数を定義します。

次のステップは、データベースに対して使用される SQL ステートメントを定義することです。この場合、更新ステートメントを発行しています。これにより、チュートリアル名が「VB.Net Complete」に更新されますが、TutorialID は変更されず、3 のままです。

次に、データベースに対して SQL ステートメントを実行するために使用されるコマンドオブジェクトを作成します。 SQL コマンドで、接続オブジェクトと SQL 文字列を渡しました。

データアダプタコマンドで、insert SQL コマンドをアダプタに関連付けます。次に、データベースに対して Update ステートメントを実行するために使用される ExecuteNonQuery メソッドも発行します。

最後に、データベース操作に関連するすべてのオブジェクトを閉じます。これは常に良い習慣であることを忘れないでください。

出力:-

実際に SQL Server Express にアクセスして demotb テーブルの行を確認すると、次のように行が正常に更新されていることがわかります。

記録の削除

データへのアクセスと同様に、C# にはデータベースから既存のレコードを削除する機能もあります。データベースからレコードを削除する方法を紹介するために、上で使用したものと同じテーブル構造を使用してみましょう。

TutorialIDTutorialName1C#2ASP.Net3VB.Net完了

次の行を削除できるように、フォームのコードを変更しましょう

TutorialIDTutorialName3VB.Net 完了

それでは、次のコードをプログラムに追加しましょう。以下のコードスニペットは、データベース内の既存のレコードを削除するために使用されます。

コードの説明:-

<オール>

このコードの主な違いは、delete SQL ステートメントを発行していることです。 delete ステートメントは、TutorialID の値が 3 である demotb テーブルの行を削除するために使用されます。

データアダプタコマンドで、insert SQL コマンドをアダプタに関連付けます。次に、データベースに対して Delete ステートメントを実行するために使用される ExecuteNonQuery メソッドも発行します。

出力:-

実際に SQL Server Express にアクセスして demotb テーブルの行を確認すると、次のように行が正常に削除されていることがわかります。

コントロールをデータに接続する

前のセクションでは、SQLCommand や SQLReader などの C# コマンドを使用してデータベースからデータをフェッチする方法を見てきました。また、テーブルの各行を読み取り、メッセージボックスを使用してテーブルの内容をユーザーに表示する方法についても説明しました。

しかし、明らかに、ユーザーはメッセージボックス経由で送信されたデータを見たくないし、データを表示するためのより優れたコントロールを望んでいます。以下のデータ構造をテーブルに取りましょう

TutorialIDTutorialName1C#2ASP.Net3VB.Net完了

上記のデータ構造から、ユーザーは理想的には、TutorialID と Tutorial Name がテキストボックスに表示されることを望んでいます。次に、テーブル内の次のレコードまたは前のレコードに移動できるボタンコントロールが必要になる場合があります。これには、開発者側で少し追加のコーディングが必要になります。

幸いなことに、C# では、コントロールをデータにバインドできるようにすることで、追加のコーディング作業を減らすことができます。これが意味することは、C# はテーブルの特定のフィールドに従ってテキストボックスの値を自動的に設定できるということです。

したがって、Windows フォームには 2 つのテキストボックスを含めることができます。次に、1 つのテキストボックスを TutorialID フィールドにリンクし、別のテキストボックスを TutorialName フィールドにリンクします。このリンクは Visual Studio デザイナー自体で行われるため、追加のコードを記述する必要はありません。

Visual Studio は、リンクが機能することを確認するためのコードを作成します。アプリケーションを実行すると、テキストボックスコントロールが自動的にデータベースに接続し、データを取得してテキストボックスコントロールに表示します。これを実現するために開発者側でコーディングを行う必要はありません。

コントロールのバインドを実現する方法のコード例を見てみましょう。

この例では、Windows フォームに 2 つのテキストボックスを作成します。これらは、それぞれチュートリアル ID とチュートリアル名を表します。それに応じて、データベースのチュートリアル ID およびチュートリアル名フィールドにバインドされます。

これを実現するには、以下の手順に従いましょう。

ステップ 1) 基本的なフォームを構築します。フォームで、ラベルとテキストボックスの 2 つのコンポーネントをドラッグアンドドロップします。次に、次のサブステップを実行します

<オール>

最初のラベルのテキスト値を TutorialID として配置

2 番目のラベルのテキスト値を TutorialName として配置

最初のテキストボックスの name プロパティを txtID として配置

2 番目のテキストボックスの name プロパティを txtName として入力します

上記の手順を実行すると、フォームは次のようになります。

ステップ 2) 次のステップは、バインディング Navigator をフォームに追加することです。バインディング Navigator コントロールは、テーブルの各行を自動的にナビゲートできます。バインディングナビゲーターを追加するには、ツールボックスに移動してフォームにドラッグするだけです。

ステップ 3) 次のステップは、バインディングをデータベースに追加することです。これは、いずれかの Textbox コントロールに移動し、DataBindings->Text プロパティをクリックすることで実行できます。 Binding Navigator は、アプリケーションからデータベースへのリンクを確立するために使用されます。

この手順を実行すると、アプリケーションがデータベースにリンクされていることを確認するために、必要なコードが Visual Studio によって自動的にアプリケーションに追加されます。通常、Visual Studio のデータベースはプロジェクトデータソースと呼ばれます。したがって、アプリケーションとデータベース間の接続を確実に確立するための最初のステップは、プロジェクトデータソースを作成することです。

次の画面が表示されます。「プロジェクトデータソースの追加」リンクをクリックします。プロジェクトデータソースをクリックすると、ウィザードが表示されます。これにより、データベース接続を定義できます。

ステップ 4) [プロジェクトデータソースの追加] リンクをクリックすると、demotb データベースへの接続を作成するために使用されるウィザードが表示されます。次の手順では、ウィザードの各手順で何を構成する必要があるかを詳しく示しています。

<オール>

ポップアップする画面で、データソースタイプとしてデータベースを選択し、[次へ] ボタンをクリックします。

次の画面では、データベースへの接続文字列の作成を開始する必要があります。アプリケーションがデータベースへの接続を確立するには、接続文字列が必要です。サーバー名、データベース名、ドライバー名などのパラメーターが含まれています。
[新しい接続] ボタンをクリックします
データソースとして Microsoft SQL Server を選択
[続行] ボタンをクリックします。

次に、データベースに接続するための認証情報を追加する必要があります
SQL Server が存在するサーバー名を選択してください
データベースに接続するためのユーザー ID とパスワードを入力してください
データベースを demotb として選択
[OK] ボタンをクリックします。

この画面では、前の画面で行ったすべての設定を確認します。
オプション「はい」を選択して、機密データを接続文字列に含めます
[次へ] ボタンをクリックします。

次の画面で、[次へ] ボタンをクリックして、接続文字列の作成を確認します

このステップでは、

<オール>

次の画面に表示される Demotb のテーブルを選択します。

このテーブルは、C# プロジェクトで使用可能なデータソースになります

[完了] ボタンをクリックすると、Visual Studio は、アプリケーションがテーブル Demotb のすべての行をクエリできることを確認します。

ステップ 5) データソースが定義されたので、TutorialID と TutorialName テキストボックスを demotb テーブルに接続する必要があります。 TutorialID または TutorialName テキストボックスの Text プロパティをクリックすると、Demotb へのバインドソースが利用可能であることがわかります。

最初のテキストボックスでは、チュートリアル ID を選択します。 2 番目のテキストボックスに対してこの手順を繰り返し、TutorialName としてフィールドを選択します。以下の手順は、各コントロールに移動し、それに応じてバインディングを変更する方法を示しています。

<オール>

チュートリアル ID コントロールをクリックします。

[プロパティ] ウィンドウに、TutorialID テキストボックスのプロパティが表示されます。テキストプロパティに移動し、下矢印ボタンをクリックします。

下矢印ボタンをクリックすると、demotbBinding Source オプションが表示されます。この下に、TutorialName と TutorialID のオプションが表示されます。チュートリアル ID を選択してください。

上記の 3 つの手順をチュートリアル名テキストボックスに対して繰り返します。

<オール>

チュートリアル名のテキストボックスをクリックします

プロパティウィンドウに移動

Text プロパティを選択します

demotbBindingSource の下の TutorialName オプションを選択します

ステップ 6) 次に、BindingNavigator の Binding Source プロパティを変更して、Demotb データソースを指すようにする必要があります。これを行う理由は、Binding Navigator も参照する必要があるテーブルを認識する必要があるためです。

Binding Navigator は、テーブル内の次または前のレコードを選択するために使用されます。したがって、データソースがプロジェクト全体とテキストボックスコントロールに追加されたとしても、バインディングナビゲーターにもデータソースへのリンクがあることを確認する必要があります。これを行うには、Binding ナビゲーターオブジェクトをクリックし、Binding Source プロパティに移動して、利用可能なものを選択する必要があります

次に、[プロパティ] ウィンドウに移動して、[バインディングソース] プロパティを変更できるようにする必要があります。

上記のすべてのステップが正常に実行されると、以下の出力が得られます。

出力:-

プロジェクトが起動されると、テキストボックスがテーブルから自動的に値を取得することがわかります。

ナビゲーターの [次へ] ボタンをクリックすると、テーブル内の次のレコードに自動的に移動します。そして、次のレコードの値がテキストボックスに自動的に入力されます

C# DataGridView

データグリッドは、テーブルのデータをグリッドのような形式で表示するために使用されます。ユーザーがテーブルデータを表示する場合、通常、すべてのテーブル行を一度に表示することを好みます。これは、フォームのグリッドにデータを表示できれば実現できます。

C# と Visual Studio には組み込みのデータグリッドがあり、これを使用してデータを表示できます。この例を見てみましょう。この例では、demotb テーブルからのチュートリアル ID とチュートリアル名の値を表示するために使用されるデータグリッドがあります。

ステップ 1) Drag the DataGridView control from the toolbox to the Form in Visual Studio. The DataGridView control is used in Visual Studio to display the rows of a table in a grid-like format.

ステップ 2) In the next step, we need to connect our data grid to the database. In the last section, we had created a project data source. Let’s use the same data source in our example.

<オール>

First, you need to choose the grid and click on the arrow in the grid. This will bring up the grid configuration options.

In the configuration options, just choose the data source as demotbBindingSource which was the data source created in the earlier section.

If all the above steps are executed as shown, you will get the below-mentioned output.

出力:-

From the output, you can see that the grid was populated by the values from the database.

まとめ

C# SQL can work with databases such as Oracle and Microsoft SQL Server.
This C# database tutorial has all the commands which are required to work with databases. This involves establishing a connection to the database. You can perform operations such as select, update, insert and delete using the commands in C#.
The DataReader object in C# is used to hold all the data returned by the database. The While loop in C# can be used to read the data rows one at a time.
The data adapter object is used to perform SQL operations such as insert, delete, and update against the database.
C# can bind controls to the various fields in a table. They are bound by defining a data source in C#. The data source is used to pull the data from the database and populate them in the controls.
The binding navigator is used to automatically navigate through the rows in a table.
The data grid in C# can connect to the database and display all the values from the table in a grid-like format.

例を使用した C# Windows フォームアプリケーションのチュートリアル C# でのファイル処理:I/O 操作 [例]

C言語