CA1046: 参照型で、演算子 equals をオーバーロードしないでください
TypeName |
DoNotOverloadOperatorEqualsOnReferenceTypes |
CheckId |
CA1046 |
カテゴリ |
Microsoft.Design |
互換性に影響する変更点 |
あり |
原因
パブリックの参照型または入れ子になったパブリックの参照型が、等値演算子をオーバーロードしています。
規則の説明
参照型の場合、等値演算子は既定の実装でほぼ問題がありません。 既定で、2 つの参照が等値と見なされるのは、同じオブジェクトを参照する場合のみです。
違反の修正方法
この規則違反を修正するには、等値演算子の実装を削除します。
警告を抑制する状況
参照型が組み込みの値型のように動作する場合は、この規則による警告を抑制しても安全です。 型のインスタンスで加算または減算を実行する意味がある場合、多くは、等値演算子を実装して警告を抑制することが適切です。
使用例
2 つの参照を比較するときの既定の動作を次の例に示します。
using System;
namespace DesignLibrary
{
public class MyReferenceType
{
private int a, b;
public MyReferenceType (int a, int b)
{
this.a = a;
this.b = b;
}
public override string ToString()
{
return String.Format("({0},{1})", a, b);
}
}
}
次のアプリケーションでは、いくつかの参照を比較しています。
using System;
namespace DesignLibrary
{
public class ReferenceTypeEquality
{
public static void Main()
{
MyReferenceType a = new MyReferenceType(2,2);
MyReferenceType b = new MyReferenceType(2,2);
MyReferenceType c = a;
Console.WriteLine("a = new {0} and b = new {1} are equal? {2}", a,b, a.Equals(b)? "Yes":"No");
Console.WriteLine("c and a are equal? {0}", c.Equals(a)? "Yes":"No");
Console.WriteLine("b and a are == ? {0}", b == a ? "Yes":"No");
Console.WriteLine("c and a are == ? {0}", c == a ? "Yes":"No");
}
}
}
この例を実行すると、次の出力が生成されます。
関連規則
CA1013: オーバーロードする加算および減算で、演算子 equals をオーバーロードします