NUnit's Assert.Equals zgłasza wyjątek "Assert.Equals nie powinien być używany do zapewnień"

Question

Niedawno podjąłem próbę użycia metody Assert.Equals() podczas pisania nowego testu NUnit. Po uruchomieniu ta metoda powoduje wyświetlenie AssertionException z informacją, że na pierwszy rzut oka jest to trochę kłopotliwe. Co tu się dzieje?

Answer 1

Assert jest klasą statyczną dziedziczącą po System.Object, ponieważ wszystkie klasy zawierają niejawnie w języku C#. System.Object realizuje się następującym sposobem:

static bool Equals(object a, object b) 

metody na twierdzić, które są przeznaczone do porównywania równości są metody Assert.AreEqual(). Dlatego wywołanie metody Object.Equals() za pośrednictwem klasy Assert w teście jednostkowym jest z pewnością błędem. Aby zapobiec temu błędowi i uniknąć pomyłki, twórcy NUnit celowo ukryli Object.Equals w klasie Assert z implementacją, która zgłasza wyjątek. Oto realizacja:

/// <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"); 
} 

Oczywiście sam komunikat Wyjątkiem jest mylące, ale przynajmniej pozwala wiedzieć zrobiłeś coś złego.

Answer 2

tldr;

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

nie:

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