A Guide to Unit Testing with Microsoft Fakes

When choosing a mocking framework for your unit tests, you may find quite many options: Moq, Rhino Mocks, NMock, EasyMock.NET, etc. All of them have the similar functionality and are open source.

However, if you or your client prefer commercial products, (e.g. due to better support and guarantees), there is one framework that deserves your interest. It’s Microsoft Fakes. It is available with Visual Studio Premium or Ultimate (starting with 2012). The distinguishing feature of this framework is a replacement of calls to assemblies that you cannot modify. For instance, you can mock System.DateTime.UtcNow of System.dll, which isn’t possible with other mocking frameworks.

In this post, I’ll tell you how you can use this framework to simplify mocking external modules in your unit tests.

Code to be tested

Let’s say we have the following scenario:

  1. DataProvider generates some data
  2. LogWriter creates a log from this data and sends it to FileWriter
  3. FileWriter write this log on the disc

The base entity in our project is Log:

A Guide to Unit Testing with Microsoft Fakes

I’m going to make a unit test for LogWriter. It’s inherited form ILogWritter interface:


Log writer is implemented this way:

LogWriter implementation

It has dependencies on IDataProvider and IFileWriter. Their implementation isn’t interesting for us, so I give you only interfaces:



Unit testing

Let’s get started with unit testing! We’ll try to write a unit test for LogWriter:

Unit testing

As you can see, LogWriter constructor requires instances of IDataProvider and IFileWriter. Let’s mock them both. We’ll use Microsoft Fakes Framework for this purpose.

The first step is adding Fakes Assembly

  1. Open references of your Unit Test Project in solution explorer
  2. Right click on the assembly that you want to mock
  3. Select “Add Fakes Assembly”

Fakes Assembly

After these steps, new reference has been added:

Add Fakes Assembly

Let’s use this Fakes Assembly to mock IDataProvider and IFileWriter.

Unit testing - MsFakesSampleTests

Fakes assembly provides Stub and Shim for each class. Stubs require that you declare your objects using interfaces rather than classes. It doesn’t allow you to mock a variety of class features like static members. But they give better performance than Shims. Shims are more flexible and work with any class members.

The one important thing that we missed is CreatedDate testing:

CreatedDate testing

The problem with CreatedDate is that we can’t set it from outside. We need to mock System.DateTime.UtcNow in some way. Let’s create Fake System.dll (as I have already mentioned, you cannot do that with any other mocking framework) and make it work as we need.



Now all pieces of code are under control.


As can you see Microsoft Fakes Framework gives us a lot of benefits. The most significant of them are the following:

  • You don’t need to find and install any additional packages for mocking
  • You can easily replace calls to any assembly (core .Net assemblies for instance)
  • It is commercial, so you can count on support.

You could face some difficulties during configuration or running your tests in Continues Integration environment. Here is a hint how to avoid that.

More information can be found here

You can also download the source code from the article here



Privacy Policy

What are you looking for?

What is your preferred office location?

How can we help you?

Simply fill in a few details in our contact form or get in touch with us by email, and one of our experts will contact you shortly.
mail info (at)
This could be the beginning of a wonderful collaboration and the easiest way to acquire a highly-experienced team.

For questions or comments regarding privacy concerns or your personal data, please submit questions via our Privacy Policy form

Like this blog post?

Subscribe to Skelia Newsletter

You have successfully subscribed to Skelia Newsletter.

There was an error while trying to send your request. Please try again.

Skelia will use the information you provide on this form to be in touch with you and to provide updates and marketing.