先生と生徒の会話形式で理解しよう

生徒

「C#を使ってデータベースからデータを読み書きしたいのですが、エラーが起きたときにプログラムが止まってしまいます。どうすればいいですか？」

先生

「データベース操作にはエラーがつきものです。C#では例外処理という仕組みを使って、エラーが起きても安全に処理を続ける方法があります。」

生徒

「例外処理...難しそうですね。ADO.NETやEntity Frameworkという言葉も聞いたことがありますが、初心者でも使いこなせますか？」

先生

「大丈夫ですよ！まずは基本となるtry-catchの書き方から、最新の便利なツールまで順番に学んでいきましょう。安全なプログラムを作るコツを伝授します！」

1. データベース操作における例外処理とは？

プログラミングの世界では、予期しない問題のことを「例外（れいがい）」と呼びます。特にデータベース（データを貯めておく倉庫のようなもの）を扱うときは、プログラム自体に間違いがなくても、さまざまな原因でエラーが発生します。

例えば、インターネットの接続が急に切れてしまったり、データベースのパスワードが間違っていたり、保存しようとしたデータが大きすぎたりする場合です。これらの問題が起きたとき、何も対策をしていないとアプリは突然終了してしまいます。これを防ぎ、ユーザーに「接続に失敗しました」と優しく伝えるための仕組みが例外処理です。

C#でデータベースを扱う方法は、大きく分けてADO.NET（エーディーオー・ドットネット）とEntity Framework（エンティティ・フレームワーク）の二種類がありますが、どちらを使う場合でもこの例外処理は必須の知識となります。

2. 例外処理の基本構造 try-catch-finally

C#でエラーに対処するための最も基本的な書き方は、try、catch、finallyという三つのブロックを使う方法です。これを「トライ・キャッチ」と呼びます。

try（トライ）：エラーが起きるかもしれない処理を書く場所です。
catch（キャッチ）：エラーが起きたときに実行される場所です。ここで「エラーが起きました」というメッセージを表示します。
finally（ファイナリー）：エラーが起きても起きなくても、最後に必ず実行される場所です。後片付けに使います。

まずは、最もシンプルな例外処理の書き方を見てみましょう。


try
{
    // ここにデータベースを開く処理などを書きます
    Console.WriteLine("データベースに接続を試みます。");
    
    // 意図的にエラーを発生させる例（実際はDB接続失敗など）
    throw new Exception("接続エラーが発生しました。");
}
catch (Exception ex)
{
    // エラーが起きたときの処理
    Console.WriteLine("エラーをキャッチしました！内容：" + ex.Message);
}
finally
{
    // 最後に必ず通る処理
    Console.WriteLine("全ての処理を終了し、後片付けをしました。");
}


データベースに接続を試みます。
エラーをキャッチしました！内容：接続エラーが発生しました。
全ての処理を終了し、後片付けをしました。

3. ADO.NETでの接続とSQLサーバーの例外

ADO.NETは、C#からデータベースを操作するための最も基礎的な部品です。これを使う場合、SqlConnection（エスケル・コネクション）などのクラスを利用します。データベース専用のエラーが発生したときは、SqlExceptionという特別な例外クラスを使うと、より詳細な情報を得ることができます。

データベースへの接続は、たとえるなら「電話をかける」ようなものです。電話線が切れていたり、相手が不在だったりすることに備えて、しっかり準備をする必要があります。特に重要なのが、接続を使い終わったら必ず「切断」することです。


using System.Data.SqlClient;

string connectionString = "Server=myServerAddress;Database=myDataBase;User Id=myUsername;Password=myPassword;";

try
{
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("データベースに無事つながりました。");
        // ここでデータを読み取ったりします
    }
}
catch (SqlException ex)
{
    // データベース特有のエラー（パスワード間違い、サーバー停止など）
    Console.WriteLine("データベースエラー番号: " + ex.Number);
    Console.WriteLine("エラーメッセージ: " + ex.Message);
}
catch (Exception ex)
{
    // その他の一般的なエラー
    Console.WriteLine("予期せぬエラー: " + ex.Message);
}

ここで登場したusingという言葉は、処理が終わったら自動的に接続を閉じてくれる便利な仕組みです。これを使うことで、finallyでわざわざ閉じなくても安全に後片付けができます。

4. Entity Frameworkでのデータ保存と例外

Entity Framework (EF)は、複雑なSQL文を書かなくても、C#のオブジェクトを操作する感覚でデータベースを扱えるようにする画期的なツールです。これをORM（オー・アール・エム）と呼びます。初心者には非常に使いやすいですが、データの保存時に「制約違反」というエラーがよく起こります。

例えば、名前を入力しなければならない項目を空っぽにして保存しようとしたり、既に登録されているメールアドレスを二重に登録しようとしたりすると、DbUpdateExceptionが発生します。


try
{
    using (var context = new MyDbContext())
    {
        var user = new User { Name = "" }; // 名前が必須なのに空にする
        context.Users.Add(user);
        context.SaveChanges(); // ここでデータベースに保存
    }
}
catch (Microsoft.EntityFrameworkCore.DbUpdateException ex)
{
    // データベースの更新に失敗した場合
    Console.WriteLine("データの保存に失敗しました。入力内容を確認してください。");
    // 詳しい原因を表示
    Console.WriteLine("詳細: " + ex.InnerException?.Message);
}

このように、特定の例外を狙い撃ちしてキャッチすることで、何が原因で失敗したのかをユーザーに正確に伝えることができるようになります。

5. トランザクション処理でデータの整合性を守る

データベース操作でとても大切な考え方に「トランザクション」があります。これは「複数の処理をひとまとめにして、全部成功するか、全部失敗させるか」という仕組みです。たとえば、銀行の振り込みを想像してください。「自分の口座からお金を引く」処理と「相手の口座にお金を足す」処理の二つがありますが、片方だけ成功してもう片方が失敗したら大変なことになりますよね。

例外処理とトランザクションを組み合わせることで、エラーが起きたときに全ての処理を「なかったこと（ロールバック）」にできます。


using (var transaction = connection.BeginTransaction())
{
    try
    {
        // 処理1：自分の口座から1000円引く
        // 処理2：相手の口座に1000円足す
        
        // 全てうまくいったら確定させる
        transaction.Commit();
        Console.WriteLine("振り込みが完了しました。");
    }
    catch (Exception)
    {
        // どこかでエラーが起きたら全て元に戻す
        transaction.Rollback();
        Console.WriteLine("エラーのため、振り込みを取り消しました。");
    }
}

6. ログ出力の重要性と記録の方法

エラーが起きたとき、画面にメッセージを出すだけでは不十分です。開発者は後から「いつ、どこで、どんなエラーが起きたのか」を調査する必要があるからです。そのために、エラーの内容をファイルなどに書き残しておくことを「ログ出力（ログしゅつりょく）」と言います。

ログには、エラーメッセージだけでなく、プログラムのどの行でエラーが起きたかを示すスタックトレースという情報も記録するのがベストプラクティスです。C#では、ex.ToString()を使うことで、詳細な技術情報を簡単に取得できます。

ただし、注意点があります。パスワードや個人情報などの機密情報をそのままログに書き込まないように気をつけましょう。セキュリティを守りつつ、原因調査に必要な情報を残すのがプロの技です。

7. ユーザーへのエラー通知の工夫

プログラムの専門的なエラーメッセージをそのままユーザーに見せてはいけません。「System.Data.SqlClient.SqlException: ネットワーク接続が確立されていません」と言われても、一般のユーザーは何をすればいいか困ってしまいます。

良い例外処理とは、技術的なエラーを「人間が理解できる言葉」に翻訳することです。

接続エラーの場合：「インターネットの接続を確認してください」
データ重複の場合：「そのメールアドレスは既に登録されています」
不明なエラーの場合：「申し訳ありません。一時的にシステムが利用できません。後ほどお試しください」

このように、原因に応じて適切なアドバイスを表示することで、ユーザーに安心感を与えることができます。これが使いやすいアプリケーションを作るための第一歩です。

8. タイムアウト設定とリトライ処理

データベースの応答が遅いとき、ずっと待ち続けるのは良くありません。ある程度の時間が経過したらあきらめる設定を「タイムアウト」と言います。また、一時的なネットワークの瞬断であれば、もう一度試せば成功することもあります。これを「リトライ処理（再試行）」と呼びます。

最新のEntity Framework Coreなどでは、このリトライ処理を自動で行ってくれる設定も備わっています。不安定なインターネット環境で使われるアプリを作る場合は、こうした「粘り強さ」をプログラムに持たせることが重要です。

9. 例外を握りつぶさないための注意点

初心者がやってしまいがちな失敗に「例外の握りつぶし」があります。catchブロックの中を空っぽにして、エラーを無視してしまうことです。これは非常に危険です。エラーが起きているのにプログラムが無理やり動き続けると、データベースの中身がめちゃくちゃになってしまう可能性があります。

エラーが起きたときは、必ず「記録する」「ユーザーに知らせる」「安全に止める」のいずれかを行うようにしましょう。例外処理は、単にエラーを隠すためのものではなく、システムを安全に守るための防護服のようなものだと考えてください。

C#のデータベース接続と例外処理を徹底解説！ADO.NETとEntity Frameworkの基本