【C#】Single()メソッドで条件を満たす唯一の要素を取得する方法

C#のLINQに用意されているSingle()メソッドは、指定した条件を満たす「たった一つの要素」を返すメソッドです。もし条件に一致する要素が複数存在する場合、例外（エラー）がスローされる点に注意が必要です。

Single()メソッドの基本的な使い方

まず、次のような文字列配列を用意します。

string[] str = { "jack", "tom", "henry", "time"};

この配列に対してSingle()メソッドを呼び出し、さらにラムダ式を使って「文字数が4より大きい」要素を抽出してみましょう。

str.AsQueryable().Single(name => name.Length > 4);

サンプルコード

以下は、実際に動作する完全なプログラム例です。

using System;
using System.Linq;
using System.Collections.Generic;

public class Demo {
    public static void Main() {
        string[] str = { "jack", "tom", "henry", "time"};

        // 文字数が4より大きい文字列を検索
        string res = str.AsQueryable().Single(name => name.Length > 4);

        Console.WriteLine(res);
    }
}

実行結果

henry

解説と注意点

上記の例では、配列内の要素のうち文字数が4を超えているのは「henry」だけなので、正常に結果が返されます。

ただし、Single()メソッドは条件に一致する要素が複数ある場合や、逆に一つも存在しない場合に例外をスローします。そのため、実行時エラーを避けたい場合は、以下の代替メソッドの利用を検討するとよいでしょう。

• SingleOrDefault()：一致する要素がない場合にnull（参照型の場合）を返す
• First() / FirstOrDefault()：最初に一致した要素を返す（複数一致でも例外にならない）

「必ず一意であるべき」というビジネスルールの検証など、要素が確実に1つだけであることを保証したい場面で、Single()メソッドは非常に有効です。