相等運算子 - 測試兩個物件相等或不相等

== (相等) 和 != (不等) 運算子可檢查其運算元是否相等。實值型別在內容相等時相等。兩個變數參考相同的儲存體時，參考型別會相等。

C# 語言參考資料記錄了 C# 語言最新版本。同時也包含即將推出語言版本公開預覽功能的初步文件。

文件中標示了語言最近三個版本或目前公開預覽版中首次引入的任何功能。

小提示

欲查詢某功能何時首次在 C# 中引入，請參閱 C# 語言版本歷史的條目。

當您針對is進行測試時，可以使用==模式比對運算符做為測試的替代方案。運算子 is 會針對所有值和參考型別使用預設相等語意。

等號比較運算子 ==

等號比較運算子 == 會在其運算元相等時傳回 true，否則傳回 false。

實值型別相等

若他們的值相等時，內建實值型別的運算元就會相等：

int a = 1 + 2 + 3;
int b = 6;
Console.WriteLine(a == b);  // output: True

char c1 = 'a';
char c2 = 'A';
Console.WriteLine(c1 == c2);  // output: False
Console.WriteLine(c1 == char.ToLower(c2));  // output: True

注意

==對於、< 、 ><=和 >= 運算子，如果任一作數不是數位（Double.NaN或 Single.NaN），則運算的結果為 false。該條件表示該 NaN 值不高於、不低於或等於任何其他 double （或 float）值，包括 NaN。如需詳細資訊和範例，請參閱 Double.NaN 或 Single.NaN 參考文章。

若基礎整數型別的對應值相等時，相同列舉類型的兩個運算元就會相等。

使用者定義結構型別預設不支援 == 運算子。若要支援 == 運算子，使用者定義結構必須多載它。

C# Tuple 具有和 == 運算子的內建支援!=。如需詳細資訊，請參閱 Tuple 型別一文中的 Tuple 相等一節。

參考型別相等

根據預設，參考類型作數，不包括記錄，如果它們參考相同的物件，則相等：

public class ReferenceTypesEquality
{
    public class MyClass
    {
        private int id;

        public MyClass(int id) => this.id = id;
    }

    public static void Main()
    {
        var a = new MyClass(1);
        var b = new MyClass(1);
        var c = a;
        Console.WriteLine(a == b);  // output: False
        Console.WriteLine(a == c);  // output: True
    }
}

如範例所示，使用者定義參考型別預設支援 == 運算子。不過，參考型別可以多載 == 運算子。若參考型別多載 == 運算子，請使用 Object.ReferenceEquals 方法檢查兩個該類型的參考是否參考相同的物件。

記錄型別相等

記錄型別預設支援 == 和 != 運算子，以提供值相等語意。也就是說，當兩個記錄操作數都是 null 或所有欄位的對應值，且自動實作的屬性相等時，兩個記錄操作數都會相等。

public class RecordTypesEquality
{
    public record Point(int X, int Y, string Name);
    public record TaggedNumber(int Number, List<string> Tags);

    public static void Main()
    {
        var p1 = new Point(2, 3, "A");
        var p2 = new Point(1, 3, "B");
        var p3 = new Point(2, 3, "A");

        Console.WriteLine(p1 == p2);  // output: False
        Console.WriteLine(p1 == p3);  // output: True

        var n1 = new TaggedNumber(2, new List<string>() { "A" });
        var n2 = new TaggedNumber(2, new List<string>() { "A" });
        Console.WriteLine(n1 == n2);  // output: False
    }
}

如上述範例所示，對於參考型別成員，會比較其參考值，而不是參考的實例。

字串相等

當兩個 string 運算元皆為 null，或兩個 string 執行個體的長度相同且在各字元位置擁有完全相同的字元，兩者就會相等：

string s1 = "hello!";
string s2 = "HeLLo!";
Console.WriteLine(s1 == s2.ToLower());  // output: True

string s3 = "Hello!";
Console.WriteLine(s1 == s3);  // output: False

字串相等比較是區分大小寫的序數比較。如需有關字串比較的詳細資訊，請參閱如何在 C# 中比較字串。

委派等號

當null兩個代理運算元相同執行時間類型時，或其調用清單長度相同且每個位置的項目相等，則兩者相等：

Action a = () => Console.WriteLine("a");

Action b = a + a;
Action c = a + a;
Console.WriteLine(object.ReferenceEquals(b, c));  // output: False
Console.WriteLine(b == c);  // output: True

這很重要

調用清單中的相等專案包含調用中的所有固定參數，包括接收者。接收者是叫用專案時所表示 this 之對象的實例。

var o1 = new object();
var o2 = new object();
var d1 = o1.ToString;
var d2 = o2.ToString;
Console.WriteLine(object.ReferenceEquals(d1, d2));  // output: False
Console.WriteLine(d1 == d2);  // output: False (different receivers)

如需詳細資訊，請參閱 C# 語言規格的委派相等運算子一節。

來自語意相同 lambda 表達式的代理並不相等，以下範例顯示：

Action a = () => Console.WriteLine("a");
Action b = () => Console.WriteLine("a");

Console.WriteLine(a == b);  // output: False
Console.WriteLine(a + b == a + b);  // output: True
Console.WriteLine(b + a == a + b);  // output: False

不等比較運算符 `!=`

若運算元不相等false，則不等式運算!=true子返回，否則。對於內建類型的運算元，運算式 x != y 會產生與運算式 !(x == y) 相同的結果。如需有關型別等號的詳細資訊，請參閱等號比較運算子一節。

以下範例示範如何使用運算 != 子：

int a = 1 + 1 + 2 + 3;
int b = 6;
Console.WriteLine(a != b);  // output: True

string s1 = "Hello";
string s2 = "Hello";
Console.WriteLine(s1 != s2);  // output: False

object o1 = 1;
object o2 = 1;
Console.WriteLine(o1 != o2);  // output: True

運算子是否可多載

你可以用使用者定義的類型超載== 和 != 運算子。如果你讓其中一位超載，另一位也必須超載。

你不能明確在記錄類型中超載 == 和 != 運算子。若要改變記錄型T別中和 != 運算子的行為==，請實作IEquatable<T>.Equals以下簽名的方法：

public virtual bool Equals(T? other);

C# 語言規格

如需詳細資訊，請參閱 C# 語言規格的關係及類型測試運算子一節。

如需記錄型別相等的詳細資訊，請參閱記錄功能提案附註的相等成員一節。

另請參閱

反饋

呢頁幫到你嗎？

Last updated on 2026-01-24