AssignableTo Constraint

AssignableToConstraint tests that the actual value can be assigned to a variable of the specified type. In other words, the actual value's type derives from or implements the expected type.

Usage

Is.AssignableTo(Type expectedType)
Is.AssignableTo()

Examples

[Test]
public void AssignableToConstraint_Examples()
{
    // A string can be assigned to object (string derives from object)
    Assert.That("Hello", Is.AssignableTo(typeof(object)));
    Assert.That("Hello", Is.AssignableTo());

    // A string can be assigned to IEnumerable
    Assert.That("Hello", Is.AssignableTo>());

    // A List can be assigned to IList
    Assert.That(new List(), Is.AssignableTo>());
    Assert.That(new List(), Is.AssignableTo>());

    // Negative: an int cannot be assigned to string
    Assert.That(5, Is.Not.AssignableTo(typeof(string)));
}

Notes


    

  1. Is.AssignableTo() is true when typeof(T).IsAssignableFrom(actual.GetType()).
    2. 

  2. This tests "can this value be assigned to a variable of type T?".
    3. 

  3. This is the reverse of AssignableFromConstraint.
    4. 



See Also