Assert NUnit.Equals melempar pengecualian "Assert.Equals tidak boleh digunakan untuk pernyataan"

Saya baru-baru ini mencoba menggunakan metode Assert.Equals () saat menulis tes NUnit baru. Setelah dieksekusi, metode ini AssertionExceptionmenyatakan bahwa Assert.Equals should not be used for Assertions. ini sedikit membingungkan pada pandangan pertama. Apa yang terjadi di sini?

Assertadalah kelas statis yang mewarisi dari System.Object, karena semua kelas dilakukan secara implisit dalam C #. System.Object mengimplementasikan metode berikut:

static bool Equals(object a, object b)

Metode Assert yang dimaksudkan untuk perbandingan kesetaraan adalah Assert.AreEqual() metode. Oleh karena itu, memanggil Object.Equals()metode melalui kelas Assert dalam unit test tentu saja merupakan kesalahan. Untuk mencegah kesalahan ini dan menghindari kebingungan, para pengembang NUnit sengaja menyembunyikan Object.Equalsdi kelas Assert dengan implementasi yang melempar pengecualian. Inilah implementasinya:

/// <summary>
 /// The Equals method throws an AssertionException. This is done
 /// to make sure there is no mistake by calling this function.
 /// </summary>
 /// <param name="a"></param>
 /// <param name="b"></param>
 [EditorBrowsable(EditorBrowsableState.Never)]
 public static new bool Equals(object a, object b)
 {
     // TODO: This should probably be InvalidOperationException
     throw new AssertionException("Assert.Equals should not be used for Assertions");
 }

Tentu saja pesan pengecualian itu sendiri membingungkan, tetapi setidaknya itu memberi tahu Anda bahwa Anda telah melakukan sesuatu yang salah.

tldr;

Assert.AreEqual(a, b); // <-- Compares a, b

tidak:

Assert.Equals(a, b); // <-- Irrelevant equality operator on Assert itself