CA1046: Não sobrecarregar o operador de equals em tipos de referência
TypeName |
DoNotOverloadOperatorEqualsOnReferenceTypes |
CheckId |
CA1046 |
<strong>Categoria</strong> |
Microsoft.design |
Alteração significativa |
Quebrando |
Causa
Um tipo de público ou aninhados referência pública sobrecarrega o operador de igualdade.
Descrição da regra
A implementação padrão do operador de igualdade para tipos de referência, quase sempre está correta. Por padrão, as duas referências são iguais, apenas se eles apontam para o mesmo objeto.
Como corrigir violações
Para corrigir uma violação desta regra, remova a implementação do operador de igualdade.
Quando suprimir avisos
É seguro eliminar um aviso esta regra quando o tipo de referência se comporta como um tipo de valor interno. Se for significativo para fazer a adição ou subtração em instâncias do tipo, é provavelmente correta implementar o operador de igualdade e suprimir a violação.
Exemplo
O exemplo a seguir demonstra o comportamento padrão, ao comparar duas referências.
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);
}
}
}
O aplicativo a seguir compara algumas referências.
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");
}
}
}
O exemplo produz a seguinte saída.
Regras relacionadas
CA1013: É igual a operador de sobrecarga em sobrecarga, adicionar e subtrair
Consulte também
Referência
Diretrizes para a implementação de Equals e o operador de igualdade (= =)