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

生徒

「先生、C#のプログラムでエラーが起きたときに例外処理を使うことは分かってきたんですけど、自分専用のエラーを作ることはできるんですか？」

先生

「いい質問ですね。C#では、独自の例外クラス、いわゆるカスタム例外を作成することができます。」

生徒

「カスタム例外ってなんですか？普通の例外とどう違うんでしょうか？」

先生

「標準で用意されている例外（例えばArgumentNullExceptionやInvalidOperationException）では表現しにくい、あなたのプログラム特有のエラーをわかりやすく扱うために使います。それでは詳しく見ていきましょう！」

1. 独自の例外クラスとは？

C#の独自の例外クラス（カスタム例外）とは、プログラマーが自分で新しく定義するエラーの種類のことです。通常、C#にはたくさんの組み込み例外クラスがありますが、それだけでは表現できない状況が出てくることがあります。

例えば、ゲームを作っていて「体力が0になったらエラーを発生させたい」と思った場合、標準の例外ではその状態を正しく表せません。そんなときに、PlayerDeadExceptionのように自分専用の例外を作ることができるのです。

カスタム例外を使うことで、エラーの意味がより明確になり、プログラムを読む人にとって理解しやすいコードになります。これはチーム開発でも特に役立ちます。

2. カスタム例外の作り方

独自の例外クラスを作成するには、Exceptionクラスを継承（けいしょう）します。継承とは「親クラスの機能を引き継いで新しいクラスを作ること」です。

基本的なコードの書き方は以下のようになります。


using System;

public class MyCustomException : Exception
{
    public MyCustomException() 
    {
    }

    public MyCustomException(string message) : base(message) 
    {
    }

    public MyCustomException(string message, Exception inner) : base(message, inner) 
    {
    }
}

このコードでは、MyCustomExceptionという新しい例外クラスを作成しています。コンストラクタを複数用意しているのは、エラーメッセージや、別の例外を含めて伝えられるようにするためです。

3. カスタム例外を実際に使ってみよう

例として、銀行口座クラスを作り、「残高不足」のときに独自の例外を発生させるコードを書いてみましょう。


using System;

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

public class BankAccount
{
    private int balance;

    public BankAccount(int initialBalance)
    {
        balance = initialBalance;
    }

    public void Withdraw(int amount)
    {
        if (amount > balance)
        {
            throw new InsufficientBalanceException("残高が不足しています。");
        }
        balance -= amount;
        Console.WriteLine($"{amount}円を引き出しました。残高: {balance}円");
    }
}

class Program
{
    static void Main()
    {
        BankAccount account = new BankAccount(1000);

        try
        {
            account.Withdraw(1500);
        }
        catch (InsufficientBalanceException ex)
        {
            Console.WriteLine("エラー発生: " + ex.Message);
        }
    }
}

このプログラムを実行すると、残高不足のときに独自のInsufficientBalanceExceptionが発生します。


エラー発生: 残高が不足しています。

4. カスタム例外を使うメリット

独自の例外クラスを作ると、次のようなメリットがあります。

エラーの意味が明確になる - 例外名を見ただけで原因がわかりやすい。
バグの調査がしやすくなる - どの種類のエラーかを判別できるため、問題の切り分けが簡単。
再利用性が高まる - 似た処理で繰り返し利用できる。
チーム開発に役立つ - 他の人がコードを読んだときに理解しやすい。

例えば「残高不足」という状態を明確に表すInsufficientBalanceExceptionを作ることで、単なるExceptionよりもはるかにわかりやすくなります。

5. 注意点とベストプラクティス

独自の例外を作るときには、いくつかの注意点があります。

Exceptionを必ず継承する - 他のクラスから継承してしまうと正しく動作しません。
クラス名に「Exception」をつける - 慣習として、例外クラスの名前は◯◯Exceptionにします。
意味のあるエラーメッセージを書く - 単なる「エラーです」ではなく、状況を具体的に説明するメッセージにしましょう。

このようにルールを守ってカスタム例外を作成すると、初心者でもエラー処理の理解が深まり、将来的に大規模なプログラムを書いたときにも役立ちます。

まとめ

C#で独自の例外クラスを作成する方法について、この記事では基礎から応用まで丁寧に解説しました。独自の例外クラスは、標準の例外では表しきれないエラー状態をわかりやすく伝えるための重要な仕組みです。特に大規模なアプリケーションや複数のプログラマーが参加する開発現場では、エラーの意味を正確に表現し、コードの可読性や保守性を高めるために欠かせない存在になります。ここでは、記事の内容を振り返りながら、補足となる知識や実際のプロジェクトで役に立つ使い方をさらに詳しくまとめていきます。

● カスタム例外の役割を深く理解しよう

独自の例外クラスは、ただ新しい名前のエラーを作るだけではありません。プログラムの中で「このエラーはこういう意味だ」と明確に伝えるための重要な要素であり、例外処理の質を大きく高めることができます。例えば、銀行アプリで「残高不足」という状態を表す場合、標準の例外を使うよりもInsufficientBalanceExceptionを使った方がはるかに直感的で、将来コードを読む人にも瞬時に意図が伝わります。

● サンプルプログラムで振り返り

ここでは、少し応用的なサンプルコードを用意しました。複数のカスタム例外を組み合わせて、エラーの種類をより細かく分類できる実践的な例です。


using System;

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

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

public class Wallet
{
    private int balance;

    public Wallet(int initial)
    {
        balance = initial;
    }

    public void Add(int amount)
    {
        if (amount < 0)
        {
            throw new NegativeAmountException("負の金額は追加できません。");
        }
        balance += amount;
    }

    public void Spend(int amount)
    {
        if (amount < 0)
        {
            throw new NegativeAmountException("負の金額は使用できません。");
        }
        if (amount > balance)
        {
            throw new LowBalanceException("所持金が不足しています。");
        }
        balance -= amount;
        Console.WriteLine($"{amount}円を使用しました。残額: {balance}円");
    }
}

class Program
{
    static void Main()
    {
        Wallet wallet = new Wallet(500);

        try
        {
            wallet.Spend(800);
        }
        catch (LowBalanceException ex)
        {
            Console.WriteLine("残額エラー: " + ex.Message);
        }
        catch (NegativeAmountException ex)
        {
            Console.WriteLine("金額エラー: " + ex.Message);
        }
    }
}

このコードでは、残額不足と不正な金額指定の2つを別々の例外として扱っています。これにより、エラーの種類がより明確になり、修正・調査がしやすくなるというメリットが生まれます。実際のプロジェクトでも、このように複数の独自例外を活用することで、大規模なシステムでもエラー処理が整理され、品質が飛躍的に向上します。

● 実務で役立つ考え方

カスタム例外は「必要なときにだけ作る」のが基本です。むやみに増やしすぎると逆にコードが複雑になってしまいます。ポイントは「その例外が存在することでコードの意味がより明確になるかどうか」です。例えば会員登録システムで、「入力値が無効」「年齢制限に該当」「メールアドレスが重複」など異なる種類のエラーを分類したい場合は、それぞれを独自の例外として定義すると整理しやすくなります。