Xceed Logo
Shop
Fluent Assertions Documentation
In This Topic
    Dictionaries
    In This Topic

    You can apply Fluent Assertions to your generic dictionaries as well. Of course you can assert any dictionary to be null or not null, and empty or not empty. Like this:

    C#
    Copy Code 
    Dictionary<int, string> dictionary;
dictionary.Should().BeNull();

dictionary = new Dictionary<int, string>();
dictionary.Should().NotBeNull();
dictionary.Should().BeEmpty();
dictionary.Add(1, "first element");
dictionary.Should().NotBeEmpty();

    You can also assert the equality of the entire dictionary, where the equality of the keys and values will be validated using their Equals implementation. Like this:

    C#
    Copy Code 
    var dictionary1 = new Dictionary<int, string>
{
    { 1, "One" },
    { 2, "Two" }
};

var dictionary2 = new Dictionary<int, string>
{
    { 1, "One" },
    { 2, "Two" }
};

var dictionary3 = new Dictionary<int, string>
{
    { 3, "Three" },
};

dictionary1.Should().Equal(dictionary2);
dictionary1.Should().NotEqual(dictionary3);

    Or you can assert that the dictionary contains a certain key or value:

    C#
    Copy Code 
    dictionary.Should().ContainKey(1);
dictionary.Should().ContainKeys(1, 2);
dictionary.Should().NotContainKey(9);
dictionary.Should().NotContainKeys(9, 10);
dictionary.Should().ContainValue("One");
dictionary.Should().ContainValues("One", "Two");
dictionary.Should().NotContainValue("Nine");
dictionary.Should().NotContainValues("Nine", "Ten");

    You can also assert that the dictionary has a certain number of items:

    C#
    Copy Code 
    dictionary.Should().HaveCount(2);
dictionary.Should().NotHaveCount(3);

dictionary1.Should().HaveSameCount(dictionary2);
dictionary1.Should().NotHaveSameCount(dictionary3);

dictionary1.Should().HaveSameCount(dictionary2.Keys);
dictionary1.Should().NotHaveSameCount(dictionary3.Keys);

    And finally you can assert that the dictionary contains a specific key/value pair or not:

    C#
    Copy Code 
    KeyValuePair<int, string> item1 = new KeyValuePair<int, string>(1, "One");
KeyValuePair<int, string> item2 = new KeyValuePair<int, string>(2, "Two");

dictionary.Should().Contain(item1);
dictionary.Should().Contain(item1, item2);
dictionary.Should().Contain(2, "Two");
dictionary.Should().NotContain(item1);
dictionary.Should().NotContain(item1, item2);
dictionary.Should().NotContain(9, "Nine");

    Chaining additional assertions is supported as well.

    C#
    Copy Code 
    dictionary.Should().ContainValue(myClass)
  .Which.SomeProperty.Should().BeGreaterThan(0);