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

生徒

「C#でエラーが出たときに表示される文章って、自分で変えられるんですか？」

先生

「はい、C#では例外メッセージをカスタマイズして、ユーザーにわかりやすいエラーメッセージを表示することができますよ。」

生徒

「なるほど！でも、プログラミング初心者の私でもできるんでしょうか？」

先生

「もちろんです。例を交えながら、初心者の方でも理解できるように解説していきますね。」

1. C#の例外とメッセージとは？

C#のプログラムを実行していると、思い通りに処理が進まずにエラーが発生することがあります。このエラーのことを例外（Exception）と呼びます。例外が起こると、プログラムはそこで止まり、エラーメッセージが画面に表示されます。

例えば「0で割り算をした」や「存在しないファイルを開こうとした」ときなどです。標準のメッセージは英語だったり専門的すぎて、初心者やアプリを使う人にはわかりにくいことがあります。そこで例外メッセージをカスタマイズすることで、「なぜエラーになったのか」「どうすれば良いのか」をわかりやすく伝えられるのです。

2. 基本的な例外メッセージのカスタマイズ方法

C#ではthrowという文を使って例外を発生させます。その際にExceptionクラスのコンストラクタに文字列を渡すことで、好きなメッセージを設定できます。


throw new Exception("この処理でエラーが発生しました。入力値を確認してください。");

このように書くと、実行時に次のようなメッセージが表示されます。


    Unhandled exception. System.Exception: この処理でエラーが発生しました。入力値を確認してください。

3. try-catchでエラーメッセージを表示する

例外はtry-catch構文を使うことで処理を止めずに扱うことができます。catchの中でex.Messageを表示すれば、カスタマイズした例外メッセージをユーザーに伝えることができます。


try
{
    throw new Exception("入力された数値が正しくありません。");
}
catch (Exception ex)
{
    Console.WriteLine("エラー内容: " + ex.Message);
}

実行すると次のように出力されます。


    エラー内容: 入力された数値が正しくありません。

これで、プログラムの利用者が「何が悪かったのか」を理解しやすくなります。

4. 独自の例外クラスでさらにわかりやすく

標準のExceptionクラスを使うだけでなく、自分専用のカスタム例外クラスを作ることもできます。これにより、エラーメッセージをさらに整理して、状況ごとに伝えることができます。


public class InputValueException : Exception
{
    public InputValueException(string message) : base(message)
    {
    }
}

class Program
{
    static void Main()
    {
        try
        {
            throw new InputValueException("数値は0以上を入力してください。");
        }
        catch (InputValueException ex)
        {
            Console.WriteLine("カスタムエラー: " + ex.Message);
        }
    }
}

このプログラムを実行すると、次のように出力されます。


    カスタムエラー: 数値は0以上を入力してください。

このように、独自の例外クラスを使えばエラーの種類ごとにわかりやすいメッセージを提示できるので、後から見ても理解しやすくなります。

5. 例外メッセージをわかりやすく書くコツ

最後に、例外メッセージをカスタマイズするときのポイントを整理します。

専門用語を避ける – 「例外」や「スタックトレース」など難しい言葉は使わずに、誰にでも理解できる文章にする。
具体的に伝える – 「エラーです」ではなく「数値は0以上を入力してください」のように、原因と対処方法を示す。
日本語で書く – 標準のメッセージは英語が多いため、初心者や一般ユーザーには日本語の方が親切。

プログラムは人だけでなく、将来自分自身も読むことになります。わかりやすいエラーメッセージを書くことは、将来の自分へのプレゼントにもなるのです。

まとめ

C#で例外メッセージを扱う作業は、とても地味に見えるかもしれませんが、実際にはアプリケーション全体の安心感や使いやすさを左右する大切な要素になります。特に初心者の段階では「例外は難しいもの」という印象を持ちやすいのですが、ひとつひとつ理解していけば、思った以上にシンプルで実践的な技術であることがわかってきます。今回の記事では、例外メッセージをカスタマイズする基礎から、独自の例外クラスを使った応用的な書き方まで確認しましたが、実際の開発でどのように役立つのかを改めて整理しておきましょう。まず、標準の例外メッセージは開発者視点では役に立ちますが、一般的なユーザーにとっては馴染みにくく、不親切な場合も少なくありません。そこで、開発者自身が意図を込めて日本語でわかりやすく説明するメッセージを作ることで、ユーザーのストレスを大きく減らすことができます。さらに、try-catch構文の中では状況に応じたメッセージを表示したり、ログに記録したり、外部へ通知したりと、柔軟なエラー処理が行えるようになります。独自例外クラスを作れば、エラーの種類ごとにメッセージや動作を整理できるため、大規模なプログラムでも管理しやすくなります。こうした工夫は、プログラムの品質全体の向上につながり、後から読み返したときの理解もしやすく、修正もスムーズになります。また、例外メッセージを考えるときには、単に技術的な内容を伝えるだけでなく、受け取った人がどう感じるか、次にどう行動すれば良いかがすぐわかる文章にすることが大切です。この視点は、初心者が学習する際にもとても役立つ考え方であり、プログラムを書くうえで身につけておきたい姿勢そのものだと言えます。特に「数値を正しく入力してください」「この操作は現在実行できません」のように、動作の理由と改善方法をセットで示す表現は、多くのアプリケーションで採用されている基本スタイルです。文章力と技術力が合わさった部分でもあり、プログラマーとしての成長を実感できるポイントでもあります。

サンプルプログラム：複数の条件でメッセージを出し分ける

例外メッセージを柔軟にカスタマイズしたいときの参考として、状況に応じてメッセージ内容を変えるサンプルも載せておきます。


using System;

public class RangeException : Exception
{
    public RangeException(string message) : base(message) { }
}

class Program
{
    static void Main()
    {
        try
        {
            int value = -5;

            if (value < 0)
            {
                throw new RangeException("入力された値が0未満です。正しい範囲の数値を入力してください。");
            }
            else if (value > 100)
            {
                throw new RangeException("入力された数値が上限を超えています。100以下の値を指定してください。");
            }

            Console.WriteLine("処理が正常に完了しました。");
        }
        catch (RangeException ex)
        {
            Console.WriteLine("範囲エラー: " + ex.Message);
        }
        catch (Exception ex)
        {
            Console.WriteLine("その他のエラー: " + ex.Message);
        }
    }
}

このように、条件ごとに異なる例外メッセージを用意すると、利用者はどこが問題だったのか具体的に理解しやすくなり、プログラムの信頼性も自然と高まります。また、例外クラスを作ることで後からの拡張も容易になり、処理が複雑になるほどそのメリットが大きくなります。例外処理は一見難しい分野ですが、丁寧に設計していくことで、むしろプログラム全体を支える強い基盤になっていくのです。

先生と生徒の振り返り会話

生徒

「今日の内容で、例外メッセージって思ったより自由に書けるし、工夫の余地が大きいってわかりました。」

先生

「そうですね。単にエラーを表示するだけでなく、読み手が理解しやすい形にすることで、プログラムの使いやすさが大きく変わってきます。」

生徒

「独自の例外クラスを作るのも難しいと思っていましたけど、実際にはメッセージを整えたり種類を分けたりするために便利なんですね。」

先生

「その通りです。例外を分類すると、後からコードを読むときの理解もしやすくなりますし、ログの整理や制御の分岐にも役立ちますよ。」

生徒

「今後アプリを作るときは、ただthrowするんじゃなくて、メッセージの内容もちゃんと考えて作っていきたいです！」

先生