NSubstitute

Argument matchers used for specifying calls to substitutes.

Match any argument value compatible with type .

Match argument that is equal to .

Match argument that satisfies . If the throws an exception for an argument it will be treated as non-matching.

Invoke any argument whenever a matching call is made to the substitute.

Invoke any argument with specified argument whenever a matching call is made to the substitute.

Invoke any argument with specified arguments whenever a matching call is made to the substitute.

Invoke any argument with specified arguments whenever a matching call is made to the substitute.

Invoke any argument with specified arguments whenever a matching call is made to the substitute.

Invoke any argument with specified arguments whenever a matching call is made to the substitute.

Arguments to pass to delegate.

Capture any argument compatible with type and use it to call the function whenever a matching call is made to the substitute.

Perform this chain of callbacks and/or always callback when called.

Perform as first in chain of callback when called.

Perform this action always when callback is called.

Throw exception returned by function as first callback in chain of callback when called.

Throw this exception as first callback in chain of callback when called.

Throw exception returned by function always when callback is called.

The type of the exception. The throw this.

Throw this exception always when callback is called.

The type of the exception. The exception.

Perform this action once in chain of called callbacks.

Keep doing this action after the other callbacks have run.

Keep throwing this exception after the other callbacks have run.

Keep throwing this exception after the other callbacks have run.

Throw exception returned by function once when called in a chain of callbacks.

The type of the exception Produce the exception to throw for a CallInfo

Throw this exception once when called in a chain of callbacks.

The type of the exception The exception to throw

Perform the given action for every call.

The action to perform for every call

Clear all the received calls

Clear all configured return results (including auto-substituted values).

Clear all call actions configured for this substitute (via When..Do, Arg.Invoke, and Arg.Do)

Clears all received calls and configured return values and callbacks.

Provides a specification for arguments for use with . Can additionally implement to give descriptions when arguments do not match.

Checks whether the satisfies the condition of the matcher. If this throws an exception the argument will be treated as non-matching.

Provides a specification for arguments for use with . Can additionally implement to give descriptions when arguments do not match.

Matches arguments of type or compatible type.

Checks whether the satisfies the condition of the matcher. If this throws an exception the argument will be treated as non-matching.

Wrapper to track that particular entry was deleted. That is needed because concurrent collections don't have a Delete method. We null the hold value to not leak memory.

Gets the nth argument to this call.

Index of argument The value of the argument at the given index

Get the arguments passed to this call.

Array of all arguments passed to this call

Gets the types of all the arguments passed to this call.

Array of types of all arguments passed to this call

Gets the argument of type `T` passed to this call. This will throw if there are no arguments of this type, or if there is more than one matching argument.

The type of the argument to retrieve The argument passed to the call, or throws if there is not exactly one argument of this type

Gets the argument passed to this call at the specified zero-based position, converted to type `T`. This will throw if there are no arguments, if the argument is out of range or if it cannot be converted to the specified type.

The type of the argument to retrieve The zero-based position of the argument to retrieve The argument passed to the call, or throws if there is not exactly one argument of this type

Adds a callback to execute for matching calls.

an action to call

Combines two enumerables into a new enumerable using the given selector.

This implementation was sanity-checked against the Edulinq implementation and Eric Lippert's implementation.

Checks if the instance can be used when a is expected.

Join the using .

Factory method which creates from the .

Describes how the does not match the condition specified by this class, or if a detailed description can not be provided for the argument.

Description of the non-match, or if no description can be provided.

Particularly poor implementation of Maybe/Option type. This is just filling an immediate need; use FSharpOption or XSharpx or similar for a real implementation.

Delegates to ThreadLocal<T>, but wraps Value property access in try/catch to swallow ObjectDisposedExceptions. These can occur if the Value property is accessed from the finalizer thread. Because we can't detect this, we'll just swallow the exception (the finalizer thread won't be using any of the values from thread local storage anyway).

Standard substitute behaviour; replace all calls with substituted behaviour.

Partial substitute; use base behaviour unless explicitly overriden.

Create a substitute for the given types.

Create an instance of the given types, with calls configured to call the base implementation where possible. Parts of the instance can be substituted using Returns().

Perform this action when called.

Perform this configured callcback when called.

Do not call the base implementation on future calls. For use with partial substitutes.

Throw the specified exception when called.

Throw an exception of the given type when called.

Throw an exception generated by the specified function when called.

*EXPERIMENTAL* Asserts the calls to the substitutes contained in the given Action were received by these substitutes in the same order. Calls to property getters are not included in the assertion.

Action containing calls to substitutes in the expected order

Clears received calls, configured return values and/or call actions for this substitute.

Specifies what to clear on the substitute. Can be combined with | to clear multiple aspects at once.

Throw an exception for this call.

Exception to throw

Throw an exception of the given type for this call.

Type of exception to throw

Throw an exception for this call, as generated by the specified function.

Func creating exception object

Throw an exception for this call made with any arguments.

Exception to throw

Throws an exception of the given type for this call made with any arguments.

Type of exception to throw

Throws an exception for this call made with any arguments, as generated by the specified function.

Func creating exception object

Set null as returned value for this call.

Set null as returned value for this call made with any arguments.

Configure default return value for all methods that return the specified type

Configure default return value for all methods that return the specified type, calculated by a function

Raise an event for an EventHandler<TEventArgs> event with the provided and .

Raise an event for an EventHandler<TEventArgs> event with the substitute as the sender and the provided .

Raise an event for an EventHandler<EventArgsT> event with the substitute as the sender and with a default instance of .

Raise an event for an EventHandler or EventHandler<EventArgs> event with the substitute as the sender and with empty EventArgs.

Raise an event of type with the provided arguments. If no arguments are provided NSubstitute will try to provide reasonable defaults.

Asserts the calls to the substitutes contained in the given Action were received by these substitutes in the same order. Calls to property getters are not included in the assertion.

Action containing calls to substitutes in the expected order

Clears last call router on SubstitutionContext for routes that do not require it.

This is to help prevent static state bleeding over into future calls.

Create a substitute for one or more types. For example: Substitute.For<ISomeType>()

Substitute for an interface or class. Be careful when specifying a class, as all non-virtual members will actually be executed. Only virtual members can be recorded or have return values specified.

The type of interface or class to substitute. Arguments required to construct a class being substituted. Not required for interfaces or classes with default constructors. A substitute for the interface or class.

Substitute for multiple interfaces or a class that implements an interface. At most one class can be specified. Be careful when specifying a class, as all non-virtual members will actually be executed. Only virtual members can be recorded or have return values specified.

The type of interface or class to substitute. An additional interface or class (maximum of one class) the substitute should implement. Arguments required to construct a class being substituted. Not required for interfaces or classes with default constructors. A substitute of type T1, that also implements T2.

Substitute for multiple interfaces or a class that implements multiple interfaces. At most one class can be specified. If additional interfaces are required use the overload. Be careful when specifying a class, as all non-virtual members will actually be executed. Only virtual members can be recorded or have return values specified.

The type of interface or class to substitute. An additional interface or class (maximum of one class) the substitute should implement. An additional interface or class (maximum of one class) the substitute should implement. Arguments required to construct a class being substituted. Not required for interfaces or classes with default constructors. A substitute of type T1, that also implements T2 and T3.

Substitute for multiple interfaces or a class that implements multiple interfaces. At most one class can be specified. Be careful when specifying a class, as all non-virtual members will actually be executed. Only virtual members can be recorded or have return values specified.

The types of interfaces or a type of class and multiple interfaces the substitute should implement. Arguments required to construct a class being substituted. Not required for interfaces or classes with default constructors. A substitute implementing the specified types.

Create a substitute for a class that behaves just like a real instance of the class, but also records calls made to its virtual members and allows for specific members to be substituted by using When(() => call).DoNotCallBase() or by setting a value to return value for that member.

The type to substitute for parts of. Must be a class; not a delegate or interface. An instance of the class that will execute real methods when called, but allows parts to be selectively overridden via `Returns` and `When..DoNotCallBase`.

Set a return value for this call.

Value to return Optionally return these values next

Set a return value for this call, calculated by the provided function.

Function to calculate the return value Optionally use these functions next

Set a return value for this call made with any arguments.

Value to return Optionally return these values next

Set a return value for this call made with any arguments, calculated by the provided function.

Function to calculate the return value Optionally use these functions next

Checks this substitute has received the following call.

Checks this substitute has received the following call the required number of times.

Checks this substitute has not received the following call.

Checks this substitute has received the following call with any arguments.

Checks this substitute has received the following call with any arguments the required number of times.

Checks this substitute has not received the following call with any arguments.

Forget all the calls this substitute has received.

Note that this will not clear any results set up for the substitute using Returns(). See for more options with resetting a substitute.

Perform an action when this member is called. Must be followed by to provide the callback.

Perform an action when this member is called with any arguments. Must be followed by to provide the callback.

Returns the calls received by this substitute.