英語で読む

次の方法で共有


Queryable.OrderBy メソッド

定義

シーケンスの要素を昇順に並べ替えます。

オーバーロード

OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>)

指定された比較子を使用してシーケンスの要素を昇順に並べ替えます。

OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>)

シーケンスの要素をキーに従って昇順に並べ替えます。

OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>)

ソース:
Queryable.cs
ソース:
Queryable.cs
ソース:
Queryable.cs

指定された比較子を使用してシーケンスの要素を昇順に並べ替えます。

public static System.Linq.IOrderedQueryable<TSource> OrderBy<TSource,TKey> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector, System.Collections.Generic.IComparer<TKey> comparer);
public static System.Linq.IOrderedQueryable<TSource> OrderBy<TSource,TKey> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector, System.Collections.Generic.IComparer<TKey>? comparer);

型パラメーター

TSource

source の要素の型。

TKey

keySelector で表される関数によって返されるキーの型。

パラメーター

source
IQueryable<TSource>

順序付ける値のシーケンス。

keySelector
Expression<Func<TSource,TKey>>

要素からキーを抽出する関数。

comparer
IComparer<TKey>

キーを比較する IComparer<T>

戻り値

要素がキーに従って並べ替えられている IOrderedQueryable<T>

例外

sourcekeySelector、または comparer は、null です。

注釈

このメソッドには、型引数が型 Expression<TDelegate> の 1 つである型のパラメーターが少なくとも 1 つ Func<T,TResult> 含まれています。 これらのパラメーターでは、ラムダ式を渡すことができます。これは に Expression<TDelegate>コンパイルされます。

メソッドは OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>)MethodCallExpression 構築されたジェネリック メソッドとして自身を呼び出すことを OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) 表す を生成します。 次に、 パラメーターの MethodCallExpressionCreateQuery<TElement>(Expression) プロパティで表される の IQueryProvider メソッドに をProvidersource渡します。 呼び出し CreateQuery<TElement>(Expression) の結果は 型 IOrderedQueryable<T> にキャストされ、返されます。

呼び出し OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) を表す式ツリーを実行した結果として発生するクエリ動作は、 パラメーターの型の source 実装によって異なります。 予期される動作は、 のsource各要素で を呼び出すことによって取得されたキーに基づいて のsource要素をkeySelector並べ替えるということです。 パラメーターは comparer 、キーの比較に使用されます。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>)

ソース:
Queryable.cs
ソース:
Queryable.cs
ソース:
Queryable.cs

シーケンスの要素をキーに従って昇順に並べ替えます。

public static System.Linq.IOrderedQueryable<TSource> OrderBy<TSource,TKey> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector);

型パラメーター

TSource

source の要素の型。

TKey

keySelector で表される関数によって返されるキーの型。

パラメーター

source
IQueryable<TSource>

順序付ける値のシーケンス。

keySelector
Expression<Func<TSource,TKey>>

要素からキーを抽出する関数。

戻り値

要素がキーに従って並べ替えられている IOrderedQueryable<T>

例外

source または keySelectornull です。

次のコード例は、 を使用 OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) してシーケンスの要素を並べ替える方法を示しています。

class Pet
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public static void OrderByEx1()
{
    Pet[] pets = { new Pet { Name="Barley", Age=8 },
                   new Pet { Name="Boots", Age=4 },
                   new Pet { Name="Whiskers", Age=1 } };

    // Sort the Pet objects in the array by Pet.Age.
    IEnumerable<Pet> query =
        pets.AsQueryable().OrderBy(pet => pet.Age);

    foreach (Pet pet in query)
        Console.WriteLine("{0} - {1}", pet.Name, pet.Age);
}

/*
    This code produces the following output:

    Whiskers - 1
    Boots - 4
    Barley - 8
*/

注釈

このメソッドには、型引数が型 Expression<TDelegate> の 1 つである型のパラメーターが少なくとも 1 つ Func<T,TResult> 含まれています。 これらのパラメーターでは、ラムダ式を渡すことができます。これは に Expression<TDelegate>コンパイルされます。

メソッドは OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>)MethodCallExpression 構築されたジェネリック メソッドとして自身を呼び出すことを OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) 表す を生成します。 次に、 パラメーターの MethodCallExpressionCreateQuery<TElement>(Expression) プロパティで表される の IQueryProvider メソッドに をProvidersource渡します。 呼び出し CreateQuery<TElement>(Expression) の結果は 型 IOrderedQueryable<T> にキャストされ、返されます。

呼び出し OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) を表す式ツリーを実行した結果として発生するクエリ動作は、 パラメーターの型の source 実装によって異なります。 予期される動作は、 のsource各要素で を呼び出すことによって取得されたキーに基づいて のsource要素をkeySelector並べ替えるということです。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0