C# Frequently Asked Questions

The C# team posts answers to common questions

When should I use == and when should I use Equals?

The Equals method is just a virtual one defined in System.Object, and overridden by whichever classes choose to do so. The == operator is an operator which can be overloaded by classes, but which usually has identity behaviour.

For reference types where == has not been overloaded, it compares whether two references refer to the same object - which is exactly what the implementation of Equals does in System.Object.

Value types do not provide an overload for == by default. However, most of the value types provided by the framework provide their own overload. The default implementation of Equals for a value type is provided by ValueType, and uses reflection to make the comparison, which makes it significantly slower than a type-specific implementation normally would be. This implementation also calls Equals on pairs of references within the two values being compared.

However, the main difference between the two types of comparison in normal use (where you're unlikely to be defining your own value types very often) is polymorphism. Operators are overloaded, not overridden, which means that unless the compiler knows to call the more specific version, it'll just call the identity version. To illustrate that, here's an example:

using System;

public class Test
{
	static void Main()
	{
        // Create two equal but distinct strings
        string a = new string(new char[] {'h', 'e', 'l', 'l', 'o'});
        string b = new string(new char[] {'h', 'e', 'l', 'l', 'o'});
        
        Console.WriteLine (a==b);
        Console.WriteLine (a.Equals(b));
        
        // Now let's see what happens with the same tests but
        // with variables of type object
        object c = a;
        object d = b;
        
        Console.WriteLine (c==d);
        Console.WriteLine (c.Equals(d));
    }
}

The results are:

True
True
False
True

The third line is False because the compiler can only call the non-overloaded version of == as it doesn't know that the contents of c and d are both string references. As they are references to different strings, the identity operator returns false.

So, when should you use which operator? My rule of thumb is that for almost all reference types, use Equals when you want to test equality rather than reference identity. The exception is for strings - comparing strings with == does make things an awful lot simpler and more readable but you need to remember that both sides of the operator must be expressions of type string in order to get the comparison to work properly.

For value types, I'd normally use == for easier-to-read code. Things would get tricky if a value type provided an overload for == which acted differently to Equals, but I'd consider such a type very badly designed to start with.

[Author: Jon Skeet]

Published Monday, March 29, 2004 11:56 PM by CSharpFAQ

Comments

 

Mark said:

I thought that structs do not get an implementation of op== by default.
April 16, 2004 10:24 AM
 

Jon Skeet said:

Hmm... you're right. I'll amend the article when I'm in a more suitable location...
April 18, 2004 10:35 AM
 

Jon Skeet said:

Article modified for correctness - thanks Mark.
April 21, 2004 2:32 AM
 

An agglomeration of my thoughts said:

April 21, 2004 10:14 AM
 

Vish said:

if this observation is correct then why this shows equality ?

string a="1";
object b="1";
Console.WriteLine(a==b);

Reply me at vkakkar@sisware.com

Thanks!
Vish
April 24, 2004 10:08 PM
 

Jon Skeet said:

Because string literals are interned - both a and b are references to the same object. Try this code instead:

string a=new string(new char[]{'1'});
object b=new string(new char[]{'1'});
Console.WriteLine(a==b);
April 26, 2004 1:44 AM
 

mrv said:

I am a beginner and would greatly appreciate if you could explain this in more detail:
"Because string literals are interned - both a and b are references to the same object."

What is "interned?"
May 19, 2004 4:15 AM
 

avnrao said:

cool blog. just few lines clear lot of doubts.
May 21, 2004 12:45 AM
 

Langleyben Leon said:

Identity vs Equivalence
June 23, 2004 1:07 PM
 

Langleyben Leon said:

Identity vs Equivalence
June 23, 2004 1:14 PM
 

Langleyben Leon said:

Identity vs Equivalence
June 23, 2004 1:15 PM
 

ok said:

July 18, 2004 12:31 AM
 

Eric Joe said:

Ping Back来自:blog.csdn.net
September 16, 2004 2:02 AM
 

RebelGeekz said:

December 28, 2004 4:54 AM
 

Bat's Blog said:

February 16, 2005 6:24 PM
 

Living .NET... said:

The notion of identity and equivalence is fundamental, yet very confusing at times. You might end up
September 7, 2006 2:15 AM
 

许晓光 said:

.NETFramework类库提供了静态方法publicstaticboolReferenceEquals(

October 30, 2007 5:41 AM
 

protsyk.com » Blog Archive » C# Interview Questions said:

November 13, 2007 5:54 AM
 

C Frequently Asked Questions When should I use and when should I | Cellulite Creams said:

June 8, 2009 11:15 PM
Anonymous comments are disabled

© 2009 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Microsoft
Page view tracker