Raising events
Let's say - for argument's sake - that we have an interface that has an event defined:
Now in a test where we have a faked instance of this interface we can raise that event whenever we want, specifying sender and event args. We could also omit the sender and the Fake will be passed as sender to the event handler. There's also a convenience method for raising with empty event args.
var robot = A.Fake<IRobot>();
robot.FellInLove += (s, e) =>
{
Console.WriteLine("Yay!");
};
// Raise the event!
robot.FellInLove += Raise.With(someEventArgs); // the "sender" will be robot
// Use the overload for empty event args
robot.FellInLove += Raise.WithEmpty(); // sender will be robot, args will be EventArgs.Empty
// Specify sender and event args explicitly:
robot.FellInLove += Raise.With(sender: robot, e: someEventArgs);
Events of type EventHandler<TEventArgs> can be raised in exactly the same way.
Note that for the .NET 4.0 version of the FakeItEasy library, TEventArgs needs to extend EventArgs to support the above syntax.
It is also possible to raise events defined using a custom delegate (a.k.a "free-form delegate"), like these:
public delegate void CustomEventHandler(object sender, CustomEventArgs e);
public delegate void FreeformEventHandler(int count);
…
event CustomEventHandler CustomEvent;
event FreeformEventHandler FreeformEvent;
To do that, you can use Raise.FreeForm.With, which automatically infers the correct delegate type:
fake.CustomEvent += Raise.FreeForm.With(fake, sampleCustomEventArgs);
fake.FreeformEvent += Raise.FreeForm.With(7);
Just as when we're trying to override a method's behavior, for FakeItEasy to raise an event, the event must be virtual (if defined on a class) or defined on an interface.