【C#】これで完璧！拡張メソッドの作り方と使い方

2023年11月7日

当ページのリンクには広告が含まれています。

C#には、クラスの継承をしなくても、既存クラスにメソッドを追加する機能、いわゆる「拡張メソッド」を作ることが出来ます。

拡張メソッドをうまく使えば、コーディングの効率を高めるとともに、可読性も向上するなどのメリットは大きく、使わないのはもったいないです。

そこで、この記事では、拡張メソッドに興味があって、これから使いたいと思う方を対象に、その作り方、使い方、注意点を分かりやすく解説していきます。

拡張メソッドとは

既存のクラスに対して、継承を使わずに追加したメソッドを「拡張メソッド」と呼んでいます。

自分が作ったクラスであれば、後から自由にメソッドが作れますが、C#に組み込まれている String や List 、Array などのクラスについては、おいそれとメソッドを追加できませんよね。

拡張メソッドを使うと、簡単な記述で、これらのクラスに自分の好きなメソッドを追加することができます。

一旦拡張メソッドを作ってしまうと、Visual Studio 上のコード補完機能（IntelliSense）で使えるようになるので、めちゃめちゃ便利になります。

拡張メソッドの作り方

拡張メソッドは難しいとお考えの方もいらっしゃいますが、実は簡単です。

あるルールさえ覚えてしまえば、通常のクラスと同じ様に記述できます。

そのルールとは・・・

記述ルール

さっそく記述方法（ルール）を図にしてみました。

パッと見た感じ、通常の static クラスとほとんど同じですね。

唯一の違いは、メソッドの第一引数の前に this というキーワードが有る点です。

それでは、それぞれの部分について簡単に解説しておきます。

まず、拡張メソッド名は、後々使う事も無いので、何でも構いません。

拡張メソッドはメソッドですから、戻り値の型、メソッド名、引数１、引数２、・・・・という具合に記述します。

大事なのは引数1です。

引数１の前に this というキーワードがありますが、これがあることで拡張メソッドとして振る舞う事ができます。

this の後に続く引数１の方は、拡張したいクラス名（クラスの型）で、次にそれを受ける変数が続きます。

このように記述することで、引数１に拡張したいクラスのオブジェクトが渡ってきますので、後は好きな処理を記述すれば完成です。

サンプルソース

下記は、StringExtention という名前の拡張メソッドを作った場合のサンプルソースです。

public static class StringExtention
{

    /// <summary>
    /// 文字列をbool型に変換する。変換できなかった場合、 alternativeValue を返す。
    /// alternateValueの初期値は false。
    /// </summary>
    /// <param name="self"></param>
    /// <param name="alternativeValue"></param>
    /// <returns></returns>
    public static bool ToBool(this string str, bool?  alternativeValue = null)
    {
        return (bool.TryParse(str, out bool value) ? value : alternativeValue??false);
    }

    /// <summary>
    /// 文字列をint型に変換する。変換できなかった場合、 alternativeValue を返す。
    /// alternateValueの初期値は 0。
    /// </summary>
    /// <param name="str"></param>
    /// <param name="alternativeValue"></param>
    /// <returns></returns>
    public static int ToInt(this string str, int? alternativeValue = null)
    {
        return (int.TryParse(str, out int value) ? value : alternativeValue??0);
    }

    /// <summary>
    /// 文字列をdouble型に変換する。変換できなかった場合、 alternativeValue を返す。
    /// alternateValueの初期値は  double.NaN。
    /// </summary>
    /// <param name="str"></param>
    /// <param name="alternativeValue"></param>
    /// <returns></returns>
    public static double ToDouble(this string str, double? alternativeValue = null)
    {
        return (double.TryParse(str, out double value) ? value : alternativeValue??double.NaN);
    }

    /// <summary>
    /// 文字列を日付型に変換する。変換できなかった場合、 alternativeValue を返す。
    /// alternateValueの初期値は DateTime.MaxValue。
    /// </summary>
    /// <param name="str"></param>
    /// <param name="alternativeValue"></param>
    /// <returns></returns>
    public static DateTime ToDateTime(this string str, DateTime? alternativeValue = null)
    {
        return (DateTime.TryParse(str, out DateTime value) ? value : alternativeValue??DateTime.MinValue);
    }

    /// <summary>
    /// 文字列をString.Formatのフォーマット文字に見立て、可変長引数を渡して文字列を作成する
    /// </summary>
    /// <param name="str"></param>
    /// <param name="args"></param>
    /// <returns></returns>
    public static string Args(this string str, params object[] args)
    {
        return string.Format(str, args);
    }
}

public static class StringExtention

{

/// <summary>

/// 文字列をbool型に変換する。変換できなかった場合、 alternativeValue を返す。

/// alternateValueの初期値は false。

/// </summary>

/// <param name="self"></param>

/// <param name="alternativeValue"></param>

/// <returns></returns>

public static bool ToBool(this string str, bool? alternativeValue = null)

{

return (bool.TryParse(str, out bool value) ? value : alternativeValue??false);

}

/// <summary>

/// 文字列をint型に変換する。変換できなかった場合、 alternativeValue を返す。

/// alternateValueの初期値は 0。

/// </summary>

/// <param name="str"></param>

/// <param name="alternativeValue"></param>

/// <returns></returns>

public static int ToInt(this string str, int? alternativeValue = null)

{

return (int.TryParse(str, out int value) ? value : alternativeValue??0);

}

/// <summary>

/// 文字列をdouble型に変換する。変換できなかった場合、 alternativeValue を返す。

/// alternateValueの初期値は double.NaN。

/// </summary>

/// <param name="str"></param>

/// <param name="alternativeValue"></param>

/// <returns></returns>

public static double ToDouble(this string str, double? alternativeValue = null)

{

return (double.TryParse(str, out double value) ? value : alternativeValue??double.NaN);

}

/// <summary>

/// 文字列を日付型に変換する。変換できなかった場合、 alternativeValue を返す。

/// alternateValueの初期値は DateTime.MaxValue。

/// </summary>

/// <param name="str"></param>

/// <param name="alternativeValue"></param>

/// <returns></returns>

public static DateTime ToDateTime(this string str, DateTime? alternativeValue = null)

{

return (DateTime.TryParse(str, out DateTime value) ? value : alternativeValue??DateTime.MinValue);

}

/// <summary>

/// 文字列をString.Formatのフォーマット文字に見立て、可変長引数を渡して文字列を作成する

/// </summary>

/// <param name="str"></param>

/// <param name="args"></param>

/// <returns></returns>

public static string Args(this string str, params object[] args)

{

return string.Format(str, args);

}

拡張メソッドの使い方

拡張メソッドは普通のメソッドとまったく同じなので、ピリオド(.)を付けて記述します。

例えば、先ほど紹介したサンプルの中にあるToDoubleというメソッドがありました。

これは、引数1（this string str）と引数2(alternativeValue)　が指定されています。

public static double ToDouble(this string str, double? alternativeValue = null)
{
    return (double.TryParse(str, out double value) ? value : alternativeValue??double.NaN);
}