IEquatable<T> インターフェイス

定義

generic <typename T>
public interface class IEquatable

public interface IEquatable<T>

type IEquatable<'T> = interface

Public Interface IEquatable(Of T)

型パラメーター

派生

Microsoft.Build.Evaluation.ProjectMetadata

Microsoft.Build.Evaluation.ProjectProperty

Microsoft.Build.Execution.ProjectMetadataInstance

Microsoft.Build.Execution.ProjectPropertyInstance

Microsoft.Build.Framework.SdkReference

その他…

例

メソッドの例を参照してください IEquatable<T>.Equals 。See the example for the IEquatable<T>.Equals method.

注釈

このインターフェイスは、値を処理できる型 (数値クラスや文字列クラスなど) によって実装されます。This interface is implemented by types whose values can be equated (for example, the numeric and string classes). 値型またはクラスは、メソッドを実装して、 Equals インスタンスの等価性を判断するための適切な型固有のメソッドを作成します。A value type or class implements the Equals method to create a type-specific method suitable for determining equality of instances.

インターフェイスは、、、 IEquatable<T> Dictionary<TKey,TValue> List<T> LinkedList<T> 、などのメソッドで等価性をテストするときに、、、などのジェネリックコレクションオブジェクトによって使用され Contains IndexOf LastIndexOf Remove ます。The IEquatable<T> interface is used by generic collection objects such as Dictionary<TKey,TValue>, List<T>, and LinkedList<T> when testing for equality in such methods as Contains, IndexOf, LastIndexOf, and Remove. ジェネリックコレクションに格納されている可能性のある任意のオブジェクトに対して実装する必要があります。It should be implemented for any object that might be stored in a generic collection.

注意 (実装者)

インターフェイスの型パラメーターを、 IEquatable<T> このインターフェイスを実装している型に置き換えます。Replace the type parameter of the IEquatable<T> interface with the type that is implementing this interface.

を実装する場合は IEquatable<T> 、およびの基本クラスの実装もオーバーライドして、その Equals(Object) GetHashCode() 動作がメソッドの動作と一致するようにする必要があり Equals(T) ます。If you implement IEquatable<T>, you should also override the base class implementations of Equals(Object) and GetHashCode() so that their behavior is consistent with that of the Equals(T) method. をオーバーライドすると Equals(Object) 、オーバーライドされた実装は、クラスの静的メソッドの呼び出しでも呼び出され Equals(System.Object, System.Object) ます。If you do override Equals(Object), your overridden implementation is also called in calls to the static Equals(System.Object, System.Object) method on your class. さらに、演算子と演算子をオーバーロードする必要があり op_Equality op_Inequality ます。In addition, you should overload the op_Equality and op_Inequality operators. これにより、すべての等しいテストで一貫性のある結果が返されるようになります。This ensures that all tests for equality return consistent results.

オーバーライドの詳細につい Equals(Object) ては、「」を参照してください Equals(Object) 。For information on overriding Equals(Object), see the Equals(Object) article.

値型の場合は、常に IEquatable<T> を実装し、 Equals(Object) パフォーマンス向上のためにをオーバーライドする必要があります。For a value type, you should always implement IEquatable<T> and override Equals(Object) for better performance. Equals(Object) ボックスの値型とは、2つの値が等しいかどうかを比較するためにリフレクションに依存します。Equals(Object) boxes value types and relies on reflection to compare two values for equality. の実装 Equals(T) とのオーバーライドは両方とも、 Equals(Object) 一貫性のある結果を返す必要があります。Both your implementation of Equals(T) and your override of Equals(Object) should return consistent results.

を実装する場合は IEquatable<T> 、 IComparable<T> 型のインスタンスを順序付けまたは並べ替えできるかどうかも実装する必要があります。If you implement IEquatable<T>, you should also implement IComparable<T> if instances of your type can be ordered or sorted. 型がを実装している場合は IComparable<T> 、ほとんどの場合にもを実装し IEquatable<T> ます。If your type implements IComparable<T>, you almost always also implement IEquatable<T>.

型が注文関係をサポートしていても、等価性が順序の関係と異なる場合があることに注意してください。Note that there are some designs where a type supports an order relation, but equality may be distinct from an ordering relation. アルファベット順に並べ替えるクラスを考えてみましょう Person 。Consider a Person class where you sort alphabetically. 同じ名前の2人のユーザーが同じように並べ替えられますが、同じユーザーではありません。Two people with the same name sort the same, but are not the same person.

メソッド

適用対象

こちらもご覧ください

• IComparable<T>
• IComparable