IComparer<T> インターフェイス
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
2 つのオブジェクトを比較するために型が実装するメソッドを定義します。
generic <typename T>
public interface class IComparerpublic interface IComparer<in T>public interface IComparer<T>type IComparer<'T> = interfacePublic Interface IComparer(Of In T)Public Interface IComparer(Of T)- T
比較するオブジェクトの型。
この型パラメーターは反変です。 つまり、指定した型、または弱い派生型のいずれかを使用することができます。 共変性および反変性の詳細については、「ジェネリックの共変性と反変性」をご覧ください。- 派生
次の例では、 インターフェイスを IComparer<T> 実装して、型 Box のオブジェクトをディメンションに従って比較します。 この例は、 クラスに対して提供されるより大きな例の Comparer<T> 一部です。
// This class is not demonstrated in the Main method
// and is provided only to show how to implement
// the interface. It is recommended to derive
// from Comparer<T> instead of implementing IComparer<T>.
public class BoxComp : IComparer<Box>
{
// Compares by Height, Length, and Width.
public int Compare(Box x, Box y)
{
if (x.Height.CompareTo(y.Height) != 0)
{
return x.Height.CompareTo(y.Height);
}
else if (x.Length.CompareTo(y.Length) != 0)
{
return x.Length.CompareTo(y.Length);
}
else if (x.Width.CompareTo(y.Width) != 0)
{
return x.Width.CompareTo(y.Width);
}
else
{
return 0;
}
}
}
' This class is not demonstrated in the Main method
' and is provided only to show how to implement
' the interface. It is recommended to derive
' from Comparer<T> instead of implementing IComparer<T>.
Public Class BoxComp
Implements IComparer(Of Box)
' Compares by Height, Length, and Width.
Public Function Compare(ByVal x As Box, ByVal y As Box) As Integer Implements _
IComparer(Of Box).Compare
If x.Height.CompareTo(y.Height) <> 0 Then
Return x.Height.CompareTo(y.Height)
ElseIf x.Length.CompareTo(y.Length) <> 0 Then
Return x.Length.CompareTo(y.Length)
ElseIf x.Width.CompareTo(y.Width) <> 0 Then
Return x.Width.CompareTo(y.Width)
Else
Return 0
End If
End Function
End Class
このインターフェイスは、 List<T>.Sort メソッドと List<T>.BinarySearch メソッドで使用されます。 コレクションの並べ替え順序をカスタマイズする方法を提供します。 このインターフェイスを実装するクラスには、 クラスと SortedList<TKey,TValue> ジェネリック クラスがSortedDictionary<TKey,TValue>含まれます。
このインターフェイスの既定の実装は クラス Comparer<T> です。 クラスは StringComparer 、型 に対してこのインターフェイスを実装します String。
このインターフェイスでは、順序付けの比較がサポートされています。 つまり、メソッドが 0 を Compare 返す場合、2 つのオブジェクトが同じ並べ替えを行うことになります。 厳密な等値比較の実装は、ジェネリック インターフェイスによって IEqualityComparer<T> 提供されます。
クラスは、メソッドのComparer<T>明示的なインターフェイス実装とDefault、オブジェクトの既定の比較子をIComparer<T>取得する プロパティを提供するためComparer<T>、インターフェイスを実装IComparer.Compareするのではなく、 クラスから派生することをお勧めします。
| Compare(T, T) |
2 つのオブジェクトを比較して、一方が他方より小さいか、同じか、または大きいかを示す値を返します。 |
| 製品 | バージョン |
|---|---|
| .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 | 2.0, 3.0, 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 | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。