この記事は機械翻訳されています。英語版の記事を表示するには、[英語] のチェック ボックスをオンにしてください。また、テキストにマウス ポインターを合わせると、ポップアップ ウィンドウに英語のテキストを表示することもできます。
翻訳
英語

Enumerable.Single<TSource> メソッド (IEnumerable<TSource>)

 

公開日: 2016年10月

シーケンスの唯一の要素を返し、シーケンス内の要素が 1 つだけでない場合は例外をスローします。

名前空間:   System.Linq
アセンブリ:  System.Core (System.Core.dll 内)

public static TSource Single<TSource>(
	this IEnumerable<TSource> source
)

パラメーター

source
Type: System.Collections.Generic.IEnumerable<TSource>

IEnumerable<T> の 1 つの要素を返します。

戻り値

Type: TSource

入力シーケンスの 1 つの要素。

型パラメーター

TSource

要素の型 sourceします。

Exception Condition
ArgumentNullException

sourcenull です。

InvalidOperationException

入力シーケンスには、複数の要素が含まれています。

または

入力シーケンスが空です。

Single<TSource>(IEnumerable<TSource>) 入力シーケンスが空の場合、メソッドが例外をスローします。 返すには null 入力シーケンスが空である場合、使用して SingleOrDefault<TSource>します。

次のコード例では、使用して Single<TSource>(IEnumerable<TSource>) を配列の唯一の要素を選択します。

string[] fruits1 = { "orange" };

string fruit1 = fruits1.Single();

Console.WriteLine(fruit1);

/*
 This code produces the following output:

 orange
*/

次のコード例に示しますを Single<TSource>(IEnumerable<TSource>) 、シーケンスに 1 個の要素が含まれていない場合は例外をスローします。

string[] fruits2 = { "orange", "apple" };
string fruit2 = null;

try
{
    fruit2 = fruits2.Single();
}
catch (System.InvalidOperationException)
{
    Console.WriteLine("The collection does not contain exactly one element.");
}

Console.WriteLine(fruit2);

/*
 This code produces the following output:

 The collection does not contain exactly one element.
*/

ユニバーサル Windows プラットフォーム
8 以降で使用可能
.NET Framework
3.5 以降で使用可能
ポータブル クラス ライブラリ
サポート対象: 移植可能 .NET プラットフォーム
Silverlight
2.0 以降で使用可能
Windows Phone Silverlight
7.0 以降で使用可能
Windows Phone
8.1 以降で使用可能
トップに戻る
表示: