MbUnit

A that registers MbUnit as a tool when the test assembly contains a reference to the MbUnit assembly.

Gets information about the tools that are used by the specified test assembly. The tool information will be included in the report as part of the framework node that contains the assembly. This method is used by authors of tools that are derived from the to provide brand and version information about the tool so that it will be visible to end users. If no tools are referenced by the assembly, it will be ignored by the .

The test assembly The tool information

Associates an annotation message of the specified type with the code element.

Sets the apartment state to be used to run the decorated test and its children unless subsequently overridden.

Gets the apartment state to be used to run the decorated test.

Applies decorations to a test. A typical use of this method is to augment the test with additional metadata or to add additional behaviors to the test.

The scope The code element

Declares that a class contains assembly-level setup and teardown methods.

Consumes a code element and applies its contributions to the scope provided by a containing pattern. This method is used to declare new tests, test parameters and other components and add them to a containing test that was defined in some other scope. For example, when enumerating test fixtures, the assembly-level pattern will call the method of the primary patterns associated with each type in an assembly. Some of these patterns will create new test fixture objects and add them as children of the containing assembly-level test. They will then call the method of each non-primary pattern associated with the type within the scope of the test fixture. Then they will typically recurse into the fixture to apply contributions defined by patterns associated with methods, fields, properties, events, constructors and generic type parameters.

The containing scope The code element to process If true, skips generating child test components. Instead the children may be populated on demand using . The implementation may safely ignore the value of this flag so long as subsequent attempts to populate children on demand are idempotent (do nothing or have no adverse side-effects).

Applies semantic actions to a test to estalish its runtime behavior. This method is called after .

The test builder The test type

Verifies that the attribute is being used correctly.

The containing scope The type

Registers a custom assembly resolver. This class cannot be inherited.

Gets the assembly resolver type.

Performs early initialization for the specified assembly.

The framework-level scope that will eventually contain the assembly-level test The assembly to process

Defines a set of assertions that enable a test to verify the expected behavior of the subject under test. This class is and so cannot be instantiated.

Returns true if there is a pending unreported assertion failure.

Provides methods for composing assertions to map over complex data structures.

Verifies that an actual value approximately equals some expected value to within a specified delta.

The type of values to be compared The type of the difference produced when the values are subtracted, for numeric types this is the same as but it may differ for other types The expected value The actual value The inclusive delta between the values Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value approximately equals some expected value to within a specified delta.

The type of values to be compared The type of the difference produced when the values are subtracted, for numeric types this is the same as but it may differ for other types The expected value The actual value The inclusive delta between the values The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that expected and actual sequences have the same number of elements and that the elements are equal and in the same order.

The type of value The expected sequence The actual sequence Thrown if the verification failed unless the current indicates otherwise

Verifies that expected and actual sequences have the same number of elements and that the elements are equal and in the same order.

The type of value The expected sequence The actual sequence The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that expected and actual sequences have the same number of elements and that the elements are equal and in the same order.

The type of value The expected sequence The actual sequence The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Verifies that expected and actual sequences have the same number of elements and that the elements are equal and in the same order.

The type of value The expected sequence The actual sequence The comparer to use, or null to use the default one The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that expected and actual sequences have the same number of elements and that the elements are equal but perhaps in a different order.

The type of value The expected sequence The actual sequence Thrown if the verification failed unless the current indicates otherwise

Verifies that expected and actual sequences have the same number of elements and that the elements are equal but perhaps in a different order.

The type of value The expected sequence The actual sequence The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Verifies that expected and actual sequences have the same number of elements and that the elements are equal but perhaps in a different order.

Verifies that unexpected and actual sequences differ in at least one element.

The type of value The unexpected sequence The actual sequence Thrown if the verification failed unless the current indicates otherwise

Verifies that unexpected and actual sequences differ in at least one element.

The type of value The unexpected sequence The actual sequence The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that unexpected and actual sequences differ in at least one element.

The type of value The unexpected sequence The actual sequence The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Verifies that unexpected and actual sequences differ in at least one element.

The type of value The unexpected sequence The actual sequence The comparer to use, or null to use the default one The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value equals some expected value.

The type of value The expected value The actual value Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value equals some expected value.

The type of value The expected value The actual value The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value equals some expected value according to a particular comparer.

The type of value The expected value The actual value The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value equals some expected value according to a particular comparer.

The type of value The expected value The actual value The comparer to use, or null to use the default one The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value equals some expected value according to a particular comparer.

The type of value The expected value The actual value The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value equals some expected value according to a particular comparer.

Asserts that two strings are equal according to a particular string comparison mode.

The expected value The actual value The string comparison type Thrown if the verification failed unless the current indicates otherwise

Asserts that two strings are equal according to a particular string comparison mode.

The expected value The actual value The string comparison type The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value does not approximately equal some unexpected value to within a specified delta.

The type of values to be compared The type of the difference produced when the values are subtracted, for numeric types this is the same as but it may differ for other types The expected value The actual value The inclusive delta between the values The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value does not equal some unexpected value.

The type of value The unexpected value The actual value Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value does not equal some unexpected value.

The type of value The unexpected value The actual value The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value does not equal some unexpected value according to a particular comparer.

The type of value The unexpected value The actual value The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value does not equal some unexpected value according to a particular comparer.

The type of value The unexpected value The actual value The comparer to use, or null to use the default one The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value does not equal some unexpected value according to a particular comparer.

The type of value The unexpected value The actual value The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value does not equal some unexpected value according to a particular comparer.

Asserts that two strings are not equal according to a particular string comparison mode.

The unexpected value The actual value The string comparison type Thrown if the verification failed unless the current indicates otherwise

Asserts that two strings are not equal according to a particular string comparison mode.

The unexpected value The actual value The string comparison type The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value is not referentially identical to some unexpected value.

The type of value The unexpected value The actual value Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value is not referentially identical to some unexpected value.

Verifies that an actual value is referentially identical to some expected value.

The type of value The expected value The actual value Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value is referentially identical to some expected value.

Verifies that a test value is between left and right values according to a particular comparer.

The type of value The actual value Inclusive minimum value Inclusive maximum value

Verifies that a test value is between left and right values according to a particular comparer.

The type of value The actual value Inclusive minimum value Inclusive maximum value The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that a test value is between left and right values according to a particular comparer.

The type of value The actual value Inclusive minimum value Inclusive maximum value The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Verifies that a test value is between left and right values according to a particular comparer.

The type of value The actual value Inclusive minimum value Inclusive maximum value The comparer to use, or null to use the default one The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that a test value is between left and right values according to a particular comparer.

Verifies that an object can be deserialized from a stream using a and returns the resulting deserialized object.

The stream to deserialize The deserialized object Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be deserialized from a stream using a and returns the resulting deserialized object.

The stream to deserialize The custom assertion message format, or null if none The custom assertion message arguments, or null if none The deserialized object Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be serialized to a stream using a and returns the resulting stream.

The value The serialized stream Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be serialized to a stream using a and returns the resulting stream.

The value The custom assertion message format, or null if none The custom assertion message arguments, or null if none The serialized stream Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be serialized then deserialized to and from a stream using a and returns the resulting deserialized object.

The value The serialized then deserialized object Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be serialized and deserialized to and from a stream using a and returns the resulting deserialized object.

The value The custom assertion message format, or null if none The custom assertion message arguments, or null if none The serialized then deserialized object Thrown if the verification failed unless the current indicates otherwise

Verifies that a string contains some expected value.

The actual value The expected substring Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a string contains some expected value.

The actual value The expected substring The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that is in the enumeration .

The type of value The enumeration of items The expected value expected to be found in the collection Thrown if the verification failed unless the current indicates otherwise

Verifies that is in the enumeration .

The type of value The enumeration of items The expected value expected to be found in the collection The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that is in the dictionary .

The type of key The type of value The dictionary of items The key expected to be found in the dictionary Thrown if the verification failed unless the current indicates otherwise

Verifies that is in the dictionary .

The type of key The type of value The dictionary of items The key expected to be found in the dictionary The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be deserialized from a stream using the specified and returns the resulting deserialized object.

The stream to deserialize The object serialization formatter The deserialized object Thrown if is null Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be deserialized from a stream using the specified and returns the resulting deserialized object.

The stream to deserialize The object serialization formatter The custom assertion message format, or null if none The custom assertion message arguments, or null if none The deserialized object Thrown if is null Thrown if the verification failed unless the current indicates otherwise

Verifies that a string does not contain some unexpected substring.

The actual value The unexpected substring Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a string does not contain some unexpected substring.

The actual value The unexpected substring The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that is not in the enumeration .

The type of value The enumeration of items The unexpected value Thrown if the verification failed unless the current indicates otherwise

Verifies that is not in the enumeration .

The type of value The enumeration of items The unexpected value The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that is not in the dictionary .

The type of key The type of value The dictionary of items The key that should not be found in the dictionary Thrown if the verification failed unless the current indicates otherwise

Verifies that is not in the dictionary .

Verifies that a block of code does not throw an exception of any type.

The action delegate to evaluate Thrown if is null Thrown if the verification failed unless the current indicates otherwise

Verifies that a block of code does not throw an exception of any type.

The action delegate to evaluate The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if is null Thrown if the verification failed unless the current indicates otherwise

Verifies that a string ends with the specified text.

The actual value The expected pattern Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a string ends with the specified text.

The actual value The expected pattern The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Always throws an . Use instead.

Signals an unconditional assertion failure.

Thrown unless the current indicates otherwise

Signals an unconditional assertion failure with a particular message.

The format of the assertion failure message The arguments for the assertion failure message format string Thrown unless the current indicates otherwise

Verifies that a string matches regular expression pattern exactly.

The actual value The regular expression pattern Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a string matches regular expression pattern exactly.

The actual value The regular expression pattern The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a string matches regular expression pattern exactly.

The actual value The regular expression pattern The regular expression options Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a string matches regular expression pattern exactly.

The actual value The regular expression pattern The regular expression options The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a string matches regular expression pattern exactly.

The actual value The regular expression Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a string matches regular expression pattern exactly.

The actual value The regular expression The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that the left value is greater than the right value according to a particular comparer.

The type of value The expected value The actual value

Verifies that the left value is greater than the right value according to a particular comparer.

The type of value The expected value The actual value The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Verifies that the left value is greater than the right value according to a particular comparer.

The type of value The expected value The actual value The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Verifies that the left value is greater than the right value according to a particular comparer.

Verifies that the left value is greater than or equal to the right value according to a particular comparer.

The type of value The expected value The actual value The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Verifies that the left value is greater or equal than right value according to a particular comparer.

Verifies that the left value is greater than or equal to the right value according to a particular comparer.

The type of value The expected value The actual value

Verifies that the left value is greater than or equal to the right value according to a particular comparer.

The type of value The expected value The actual value The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Terminates the test and reports an inconclusive test outcome.

Thrown always

Terminates the test and reports an inconclusive test outcome.

The custom message format string, or null if none The custom message arguments, or null if none Thrown always

Verifies that an object may be assigned to a variable of the specified type.

The Type to compare with the object's Type The object under examination Thrown if is null

Verifies that an object may be assigned to a variable of the specified type.

The Type to compare with the object's Type The object under examination The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if is null

Verifies that an object may be assigned to a variable of the specified type.

The Type to compare with the object's Type The object under examination

Verifies that an object may be assigned to a variable of the specified type.

The Type to compare with the object's Type The object under examination The custom assertion message format, or null if none The custom assertion message arguments, or null if none

Verifies that an actual value contains no elements.

The actual value Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value contains no elements.

The actual value The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value is false.

The actual value Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value is false.

The actual value The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value is an instance of some expected type.

The expected type The actual value Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that an actual value is an instance of some expected type.

The expected type The actual value The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that an actual value is an instance of some expected type.

The expected type The actual value Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value is an instance of some expected type.

Verifies that an object may not be assigned to a variable of the specified type.

The Type to compare with the object's Type The object under examination Thrown if is null

Verifies that an object may not be assigned to a variable of the specified type.

The Type to compare with the object's Type The object under examination The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if is null

Verifies that an object may not be assigned to a variable of the specified type.

The Type to compare with the object's Type The object under examination

Verifies that an object may not be assigned to a variable of the specified type.

The Type to compare with the object's Type The object under examination The custom assertion message format, or null if none The custom assertion message arguments, or null if none

Verifies that an actual value contains at least one element.

The actual value Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value contains at least one element.

The actual value The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value is not an instance of some unexpected type.

The unexpected type The actual value Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that an actual value is not an instance of some unexpected type.

The unexpected type The actual value The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that an actual value is not an instance of some unexpected type.

The unexpected type The actual value Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value is not an instance of some unexpected type.

Verifies that an actual value is not null.

The actual value Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value is not null.

The actual value The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value is null.

The actual value Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value is null.

The actual value The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that a type supports the runtime serialization protocol.

The type to verify Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a type supports the runtime serialization protocol.

The type to verify The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that an actual value is true.

The actual value Thrown if the verification failed unless the current indicates otherwise

Verifies that an actual value is true.

The actual value The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Verifies that a type supports the Xml serialization protocol used by .

The type to verify Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a type supports the Xml serialization protocol used by .

Verifies that the left value is less than the right value according to a particular comparer.

The type of value The expected value The actual value

Verifies that the left value is less than the right value according to a particular comparer.

The type of value The expected value The actual value The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Verifies that the left value is less than the right value according to a particular comparer.

The type of value The expected value The actual value The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Verifies that the left value is less than the right value according to a particular comparer.

Verifies that the left value is less than or equal to the right value according to a particular comparer.

The type of value The expected value The actual value

Verifies that the left value is less than or equal to the right value according to a particular comparer.

The type of value The expected value The actual value The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Verifies that the left value is less than or equal to the right value according to a particular comparer.

The type of value The expected value The actual value The comparer to use, or null to use the default one Thrown if the verification failed unless the current indicates otherwise

Verifies that the left value is less than or equal to the right value according to a particular comparer.

Verifies that a string contains a full or partial match of a regular expression pattern.

The actual value The regular expression pattern Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a string contains a full or partial match of a regular expression pattern.

The actual value The regular expression pattern The regular expression options Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a string contains a full or partial match of a regular expression pattern.

The actual value The regular expression Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a string contains a full or partial match of a regular expression pattern.

Evaluates a block of code that contains multiple related assertions.

The action to invoke Thrown if is null

Evaluates a block of code that contains multiple related assertions.

The action to invoke The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if is null

Verifies that a test value is not between left and right values according to a particular comparer.

The type of value The actual value Inclusive minimum value Inclusive maximum value

Verifies that a test value is not between left and right values according to a particular comparer.

Verifies that a string does not contain a full or partial match of a regular expression pattern.

The actual value The regular expression pattern Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a string does not contain a full or partial match of a regular expression pattern.

The actual value The regular expression pattern The regular expression options Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a string does not contain a full or partial match of a regular expression pattern.

The actual value The regular expression Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a string does not contain a full or partial match of a regular expression pattern.

Always throws an . Use instead.

Verifies that an object can be serialized to a stream using the specified and returns the resulting stream.

The value The object serialization formatter The serialized stream Thrown if is null Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be serialized to a stream using the specified and returns the resulting stream.

The value The object serialization formatter The custom assertion message format, or null if none The custom assertion message arguments, or null if none The serialized stream Thrown if is null Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be serialized then deserialized to and from a stream using the specified and returns the resulting deserialized object.

The value The object serialization formatter The serialized then deserialized object Thrown if is null Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be serialized and deserialized to and from a stream using the specified and returns the resulting deserialized object.

The value The object serialization formatter The custom assertion message format, or null if none The custom assertion message arguments, or null if none The serialized then deserialized object Thrown if is null Thrown if the verification failed unless the current indicates otherwise

Verifies that a string starts with the specified text.

The actual value The expected pattern Thrown if the verification failed unless the current indicates otherwise Thrown if is null

Verifies that a string starts with the specified text.

Terminates the test and reports a specific test outcome.

The desired test outcome Thrown always

Terminates the test and reports a specific test outcome.

The desired test outcome The custom message format string, or null if none The custom message arguments, or null if none Thrown always

Terminates the test silently and reports a specific test outcome.

The desired test outcome Thrown always

Terminates the test silently and reports a specific test outcome.

The desired test outcome The custom message format string, or null if none The custom message arguments, or null if none Thrown always

Verifies that a block of code throws an exception of a particular type.

The expected type of exception The action delegate to evaluate The exception that was thrown Thrown if is null Thrown if the verification failed unless the current indicates otherwise

Verifies that a block of code throws an exception of a particular type.

The expected type of exception The action delegate to evaluate The custom assertion message format, or null if none The custom assertion message arguments, or null if none The exception that was thrown Thrown if is null Thrown if the verification failed unless the current indicates otherwise

Verifies that a block of code throws an exception of a particular type.

The expected exception type The action delegate to evaluate The exception that was thrown Thrown if or is null Thrown if the verification failed unless the current indicates otherwise

Verifies that a block of code throws an exception of a particular type.

The expected exception type The action delegate to evaluate The custom assertion message format, or null if none The custom assertion message arguments, or null if none The exception that was thrown Thrown if or is null Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be deserialized from Xml using an and returns the resulting deserialized object.

The Xml The deserialized object Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be deserialized from Xml using an and returns the resulting deserialized object.

The Xml The custom assertion message format, or null if none The custom assertion message arguments, or null if none The deserialized object Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be serialized to Xml using an and returns the resulting Xml as a string.

The value The serialized Xml Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be serialized to Xml using an and returns the resulting Xml as a string.

The value The custom assertion message format, or null if none The custom assertion message arguments, or null if none The serialized Xml Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be serialized then deserialized to and from Xml using an and returns the resulting deserialized object.

The value The serialized then deserialized object Thrown if the verification failed unless the current indicates otherwise

Verifies that an object can be serialized then deserialized to and from Xml using an and returns the resulting deserialized object.

Defines methods used with the syntax for mapping assertions over complex data structures. This is a and so cannot be inherited or instantiated.

Evaluates an assertion over key/value pairs with identical keys drawn from two dictionaries.

The key type The expected value type The expected value type The left dictionary, or null The right dictionary, or null The assertion to evaluate over all pairs, with the left value as first argument, and right value as second Thrown if the verification failed unless the current indicates otherwise

Evaluates an assertion over key/value pairs with identical keys drawn from two dictionaries.

The key type The expected value type The expected value type The left dictionary, or null The right dictionary, or null The assertion to evaluate over all pairs, with the key as first argument, left value as second, and right value as third Thrown if the verification failed unless the current indicates otherwise

Evaluates an assertion over key/value pairs with identical keys drawn from two dictionaries.

The key type The expected value type The expected value type The left dictionary, or null The right dictionary, or null The assertion to evaluate over all pairs, with the left value as first argument, and right value as second The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Evaluates an assertion over key/value pairs with identical keys drawn from two dictionaries.

The key type The expected value type The expected value type The left dictionary, or null The right dictionary, or null The assertion to evaluate over all pairs, with the key as first argument, left value as second, and right value as third The custom assertion message format, or null if none The custom assertion message arguments, or null if none Thrown if the verification failed unless the current indicates otherwise

Evaluates an assertion over pairs of values taken from two sequences.

The left value type The right value type The left sequence, or null The right sequence, or null The assertion to evaluate given a left value and a right value

Evaluates an assertion over pairs of values taken from two sequence.

The left value type The right value type The left sequence, or null The right sequence, or null The assertion to evaluate given a left value and a right value The custom assertion message format, or null if none The custom assertion message arguments, or null if none

Associates the author's name and email address with a test fixture, test method, test parameter or other test component.

Gets or sets the author's email address or an empty string if none.

Gets or sets the author's homepage or an empty string if none.

Gets or sets the author's name.

Gets the metadata key / value pairs to be added to the test component.

The metadata entries

The bind attribute overrides the default binding rules for a test parameter by specifying a different data source, a binding path or an index. At most one such attribute may appear on any given test parameter.

Gets the binding index, or null if none.

Gets the binding path, or null if none.

Gets or sets the name of the data source to bind, or null to bind the default data source for the test parameter. The default source for a test parameter is the anonymous data source defined within the scope of the test parameter or by its enclosing test.

Applies decorations to a . A typical use of this method is to augment the test parameter with additional metadata or to add additional behaviors to the test parameter.

The slot scope The slot

Associates a category name with a test fixture, test method, test parameter or other test component. The category name can be used to classify tests and build test suites of related tests.

Gets the name of the category.

Gets the metadata key / value pairs to be added to the test component.

The metadata entries

Provides a column of literal values as a data source.

Gets the array of values in the column.

Populates the data source with the contributions of this attribute.

The scope The data source The code element

Sets the join strategy of a test to be combinatorial.

Gets the join strategy to use.

The join strategy

An abstract base class for data source attributes that obtain contents from a local file, manifest resource, or inline data. At most one location type may be used. This class is and so cannot be instantiated.

Gets or sets the inline data contents as a string.

Gets or sets the path of a local file relative to the current working directory from which the file contents should be read.

Returns true if the contents are dynamic, or false if they are static. Static contents can only change if the test assembly is recompiled.

Gets or sets the path of a manifest resource from which the contents should be read. The path will be resolved within the assembly containing the type or the test fixture type if none if provided. During resolution, a resource name is constructed from the resource path by translating backslashes to periods. If the named resource is found within the scoped assembly manifest, it is used. Otherwise, the name is prepended with the scoped type's namespace and second lookup is attempted. If this final attempt fails, then an error is raised at runtime. Examples: If the is MyNamespace.MyType within assembly MyAssembly.dll and if is "Resources\Image.gif", then resolution will first check whether Resources.Image.gif in MyAssembly.dll is a valid resource. If not found, it will consider MyNamespace.Resources.Image.gif. If still not found, then a runtime error will be raised.If no is provided, then the containing test fixture type will be used as the resource scope. The above resolution strategy still applies.

Gets or sets a that is used to locate the assembly and namespace within which to resolve a manifest resource in combination with the property. If no value is specified, the test fixture type is used as the resource scope.

Gets the name of the location that is providing the data, or null if none. The name will be the filename or resource path if specified, or a special locale-aware string (such as "<inline>") if the contents were specified inline via the property.

Opens the contents as a stream.

The code element to which the attribute was applied The stream

Opens the contents as a text reader.

The code element to which the attribute was applied The text reader

Verifies that the attribute is being used correctly.

The scope The code element

Validates the data source properties of the content attribute.

The pattern scope The code element to which the attribute was applied

Provides data from Comma Separated Values contents.

Gets or sets a character that indicates that a line in the source represents a comment. May be set to '\0' (null) to disable comment handling. Comment lines are excluded from the record set.

The default value is '#' (pound).

Gets or sets the field delimiter character.

The default value is ',' (comma).

Gets or sets whether the CSV document has a header that should be used to provide aliases for indexed columns.

The default value is 'false' which indicates that the file does not have a header.

Populates the data source with the contributions of this attribute.

The scope The data source The code element

An abstract base class for MbUnit attributes that contribute values to data sources along with metadata such a description or expected exception type. This class is and so cannot be instantiated.

Gets or sets a description of the values provided by the data source.

Gets or sets the type of exception that should be thrown when the values provided by the data source are consumed by test.

Gets the metadata for the data source.

The metadata keys and values

Specifies the default test case timeout for all tests in the test assembly.

Gets the timeout, or null if none.

Gets the default timeout in seconds, or zero if none.

Applies decorations to an assembly-level test. A typical use of this method is to augment the test with additional metadata or to add additional behaviors to the test.

The assembly scope The assembly

Specifies the maximum number of concurrent threads to use when tests are run in parallel for all tests in the test assembly.

Gets the degree of parallelism.

Applies decorations to an assembly-level test. A typical use of this method is to augment the test with additional metadata or to add additional behaviors to the test.

The assembly scope The assembly

Creates a dependency from this test assembly, test fixture or test method on some other test fixture or test method.

Gets the dependent test fixture type, or null if the dependency is on another test method of this test fixture.

Gets the dependent test method name, or null if the dependency is on the whole test fixture.

Gets the code element that declares the tests on which this test should depend.

The scope The code element The code element representing the dependency

Associates a description with a test fixture, test method, test parameter or other test component.

Gets or sets the description.

Gets the metadata key / value pairs to be added to the test component.

The metadata entries

Specifies a method that is used to generate tests dynamically at runtime.

Executes the test method.

The test instance state, not null The test method result

Declares that the associated test is expected to throw an .

Declares that the associated test is expected to throw an exception of a particular type.

Gets the expected exception type.

Gets or sets the expected exception message, or null if none specified.

Applies decorations to a method-level test. A typical use of this method is to augment the test with additional metadata or to add additional behaviors to the test.

The method scope The method

Indicates that a test should only be run explicitly. The test will still appear in the test tree but it will not run and it will not appear in the test results unless it is explicitly selected for execution.

Gets the reason that the test should only run explicitly.

Applies decorations to a test. A typical use of this method is to augment the test with additional metadata or to add additional behaviors to the test.

The scope The code element

Specifies a factory member that will provide values for a data-driven test.

Gets or sets the number of columns produced by the factory, or 0 if unknown. Defaults to 0.

The number of columns Thrown if is less than zero

Gets or sets the kind of the factory. Defaults to .

The kind of the factory.

Gets the factory member name, never null.

Gets the declaring type of the factory, or null if it is assumed to be the fixture class.

Populates the data source with the contributions of this attribute.

The scope The data source The code element

Specifies a method that is to be invoked after a fixture instance has been created to complete its initialization before test fixture setup runs.

Applies decorations to the containing test.

The containing scope The method to process

Verifies that the attribute is being used correctly.

The containing scope The method

Specifies a method that is to be invoked to set up the state of a fixture before any of its tests are executed.

Applies decorations to the containing test.

The containing scope The method to process

Verifies that the attribute is being used correctly.

The containing scope The method

Specifies a method that is to be invoked to tear down the state of a fixture after all of its tests have been executed.

Applies decorations to the containing test.

The containing scope The method to process

Verifies that the attribute is being used correctly.

The containing scope The method

Defines names as aliases for the columns in an indexed data source such as those that have been populated by or . The names may subsequently be used in data binding expressions in place of their corresponding column indices.

Gets the array of column names.

Populates the data source with the contributions of this attribute.

The scope The data source The code element

Indicates that a test is to be ignored by the framework and will not be run. The test will still appear in test reports along with the reason that it was ignored, if provided.

Gets the reason that the test has been ignored, or an empty string if none.

Applies decorations to a test. A typical use of this method is to augment the test with additional metadata or to add additional behaviors to the test.

The scope The code element

Associates a with a test fixture, test method, test parameter or other test component.

Gets or sets the importance.

Gets the metadata key / value pairs to be added to the test component.

The metadata entries

An abstract class for attributes that specify the join strategy of a test. This class is and so cannot be instantiated.

Gets the join strategy to use.

The join strategy

Processes a code element and applies its contributions to the scope of this pattern. The scope will typically have been introduced by the method of a primary pattern applied to this code element. This method is used by patterns to decorate tests and test parameters that have been declared by primary patterns. For example, the method will typically be called by another pattern that has just created a new test based on the associated code element, such as a test method. The method then has the opportunity to modify the test to add metadata, change its name, add new behaviors, and so on.

The scope The code element to process

Verifies that the attribute is being used correctly.

The scope The code element Thrown if the attribute is being used incorrectly

Associates custom metadata with a test fixture, test method, test parameter or other test component. The metadata can be used for documentation, classification or dynamic customization of tests.

Gets the metadata key.

Gets the metadata value.

Gets the metadata key / value pairs to be added to the test component.

The metadata entries

Runs the test as if it were surrounded by so that multiple assertion failures within the test are tolerated.

Applies decorations to a method-level test. A typical use of this method is to augment the test with additional metadata or to add additional behaviors to the test.

The method scope The method

Overrides the name of a test or test parameter.

Gets the overridden name.

The scope The code element to process

Verifies that the attribute is being used correctly.

The scope The code element Thrown if the attribute is being used incorrectly

Sets the join strategy of a test to be pairwise.

Gets the join strategy to use.

The join strategy

Specifies that a test can be run in parallel with other parallelizable tests.

Gets the scope to which the parallelizable attribute applies.

Applies decorations to a test. A typical use of this method is to augment the test with additional metadata or to add additional behaviors to the test.

The scope The code element

Declares that a property, field, method parameter, constructor parameter, generic type parameter or generic method parameter represents a test parameter.

Indicates that a test has pending prerequisites so it will not be run. The test will still appear in test reports along with an explanation of the reason it it pending, if provided.

Gets the reason that the test is pending.

Applies decorations to a test. A typical use of this method is to augment the test with additional metadata or to add additional behaviors to the test.

The scope The code element

Decorates a test method and causes it to be invoked repeatedly.

Applies decorations to a test. A typical use of this method is to augment the test with additional metadata or to add additional behaviors to the test.

The scope The code element

Decorates a test method whose database operation must be executed within a transaction and rolled back when it has finished executing.

When set to true, includes setup and teardown in the rollback. Otherwise only transactions performed during the test itself are affected. The fixture setup and teardown is not included regardless unless this attribute is applied to the fixture class itself instead of the test method.

Applies decorations to a test. A typical use of this method is to augment the test with additional metadata or to add additional behaviors to the test.

The scope The code element

Provides a row of literal values as a data source.

Gets the array of values in the row.

Populates the data source with the contributions of this attribute.

The scope The data source The code element

Sets the join strategy of a test to be sequential.

Gets the join strategy to use.

The join strategy

Specifies a method that is to be invoked before each test in a fixture executes to set up the state of the test. The method will run once for each test. This class cannot be inherited.

Specifies a method that is used to generate tests statically at test exploration time.

Applies decorations to the containing test.

The containing scope The method to process

Verifies that the attribute is being used correctly.

The containing scope The method

Specifies a method that is to be invoked after each test in a fixture executes to tear down the state of the test. The method will run once for each test. This class cannot be inherited.

Describes a test generated either at test exploration time or at test execution time by a test factory. This class is and so cannot be instantiated.

Builds a static test during test exploration.

The containing pattern evaluation scope The code element that represents the scope in which the test was defined

Builds a collection of static tests during test exploration.

The enumeration of tests to build as children of the containing scope The containing pattern evaluation scope The code element that represents the scope in which the test was defined Thrown if , or is null or contains a null

Runs a dynamic test during test execution.

The code element that represents the scope in which the test was defined Optional set-up code to run before the test, or null if none Optional tear-down code to run after the test, or null if none

Runs a collection of dynamic tests during test execution.

The enumeration of tests to run The code element that represents the scope in which the test was defined Optional set-up code to run before the test, or null if none Optional tear-down code to run after the test, or null if none Thrown if or is null or contains a null

Specifies that a method represents a single test case within a fixture.

Executes the test method.

The test instance state, not null The test method result

Describes a test case generated either at test exploration time or at test execution time by a test factory.

Gets the delegate to run as the main body of the test case.

Returns true if the test represents an individual test case.

Gets the test kind.

Executes the main body of the test, excluding its children (which will run afterwards).

An abstract base class for implementing new test decorator behaviors. This class is and so cannot be instantiated.

Applies decorations to a test. A typical use of this method is to augment the test with additional metadata or to add additional behaviors to the test.

The scope The code element

Disposes the test.

The test instance state, not null

Executes the test.

The test instance state, not null

Initializes the test.

The test instance state, not null

Sets up the test.

The test instance state, not null

Tears down the test.

The test instance state, not null

Abstract class for custom test definitions such as generated test cases and test suites. This class is and so cannot be instantiated.

Gets or sets the code element associated with the test, or null if none.

Gets or sets the description metadata of the test, or null if none.

Returns true if the test represents an individual test case.

Gets the test kind.

Gets a mutable table of metadata entries associated with the test.

Gets the test name.

Gets or sets the maximum amount of time the whole test including its setup, teardown and body should be permitted to run. If the test runs any longer than this, it will be aborted by the framework. The timeout may be null to indicate the absence of a timeout.

The timeout. Default value is null. Thrown if represents a negative time span

Builds a static test during test exploration.

The containing pattern evaluation scope The code element that represents the scope in which the test was defined

Gets the children of this test.

Executes the main body of the test, excluding its children (which will run afterwards).

Runs set-up code before each child.

Runs set-up code before execute and before all children.

Runs tear-down code after each child.

Runs tear-down code after execute and after all children.

Runs a dynamic test during test execution.

The code element that represents the scope in which the test was defined Optional set-up code to run before the test, or null if none Optional tear-down code to run after the test, or null if none

Specifies that a class represents a test fixture. This attribute is optional.

Describes a reference to another test fixture. This is used to enable test suites to include tests that are defined using attributes.

Gets the referenced test fixture type, or null if the reference is on a test method of the containing test fixture.

Builds a static test during test exploration.

The containing pattern evaluation scope The code element that represents the scope in which the test was defined

Runs a dynamic test during test execution.

The code element that represents the scope in which the test was defined Optional set-up code to run before the test, or null if none Optional tear-down code to run after the test, or null if none

Associates the name of the type under test with a test fixture, test method, test parameter or other test component.

Gets the full name or assembly qualified name of the type under test.

The name of the type under test as obtained by or .

Gets the metadata key / value pairs to be added to the test component.

The metadata entries

Describes a test suite generated either at test exploration time or at test execution time by a test factory.

Gets a mutable list of the children of this test.

Returns true if the test represents an individual test case.

Gets the test kind.

Gets or sets a delegate to run before each test case in the suite, or null if none.

Gets or sets a delegate to run before all test cases in the suite, or null if none.

Gets or sets a delegate to run after all test cases in the suite, or null if none.

Gets or sets a delegate to run after each test case in the suite, or null if none.

Gets the children of this test.

Runs set-up code before each child.

Runs set-up code before execute and before all children.

Runs tear-down code after each child.

Runs tear-down code after execute and after all children.

Decorates a test method and causes it to be invoked repeatedly on multiple concurrent threads.

Applies decorations to a test. A typical use of this method is to augment the test with additional metadata or to add additional behaviors to the test.

The scope The code element

Sets the maximum amount of time in seconds that a test or fixture is permitted to run.

Gets the timeout, or null if none.

Gets the test timeout in seconds, or zero if none.

Applies decorations to a test. A typical use of this method is to augment the test with additional metadata or to add additional behaviors to the test.

The scope The code element

Provides data from XML contents.

Populates the data source with the contributions of this attribute.

The scope The data source The code element

Specifies the test's relative importance which can be used for classifying tests to be executed.

Critical importance.

Severe importance. Less important than .

Serious importance. Less important than .

Default importance.

Not important.

Specifies the scope to which certain attributes apply.

Applies to this test only.

Applies to the descendants of this test only.

Applies to this test and its descendants.

Abstract base class for contracts. This class is and so cannot be instantiated.

Gets the execution context.

Verifies that the specified method info object is not null, indicating that the method exists, otherwise raises an assertion failure and describes the expected method signature.

The method, or null if missing The expected method signature for diagnostic output

Gets an enumeration of test cases whose purpose is to verify the contract.

The context of execution. An enumeration of tests

Gets an enumeration of test cases whose purpose is to verify the contract.

An enumeration of tests

Gets the interface of a particular type if it is implemented by another type, otherwise returns null.

The implementation type The interface type The interface type or null if it is not implemented by the implementation type

Contract for verifying the implementation of the generic . Built-in verifications: VerifyReadOnlyPropertyThe property returns a value in accordance to the expected result determined in the declaration of the contract verifier, by setting the property . By default, the collection is expected to be not read-only (items can be added and removed, and the collection to be cleared).AddShouldThrowExceptionThe read-only collection throws an exception when the method is called. The test is not run when the contract property is set to 'false'. RemoveShouldThrowExceptionThe read-only collection throws an exception when the method is called. The test is not run when the contract property is set to 'false'. ClearShouldThrowExceptionThe read-only collection throws an exception when the method is called. The test is not run when the contract property is set to 'false'. AddNullArgumentThe collection throwns a when the method is called with a null reference item. The test is not run when the contract property is set to 'true'. RemoveNullArgument The collection throwns a when the method is called with a null reference item. The test is not run when the contract property is set to 'true'. ContainsNullArgument The collection throwns a when the method is called with a null reference item. The test is not run when the contract property is set to 'true'. AddItems The collection handles correctly with the addition of new items. The method and the property are expected to return suited results as well. The case of duplicate items (object equality) is tested too; according to the value of contract property . The test is not run when the contract property is set to 'true'. RemoveItems The collection handles correctly with the removal of items. The method and the property are expected to return suited results as well. The test is not run when the contract property is set to 'true'. ClearItems The collection is cleared as expected when the method is called. The test is not run when the contract property is set to 'true'. CopyTo Not implemented yet. The test already succeeds.

The type of the collection implementing . The type of items contained in the collection.

Determines whether the collection is expected to accept several identical items (object equality). The default value is true. The default value is 'true'.

Determines whether the collection is expected to accept null references as valid items. The default value is 'false'.

Gets a collection of distinct object instances that feeds the different tests. In order to optimize the tests, consider to provide: items which are not in the default collection instance yet. items which are in the default collection instance already (if not empty).

Provides a default instance of the collection to test. By default, the contract verifier attempts to invoke the default constructor to get an valid instance. Overwrite the default provider if the collection has no default constructor, or if you want the contract verifier to use a particular instance.


            [VerifyContract]
            public readonly IContract CollectionTests = new CollectionContract<MyCollection, int>
            {
                GetDefaultInstance = () => new MyCollection(1, 2, 3)
            };

Determines whether the tested collection is expected to be read-only. The default value is 'false'.

Asserts that the collection of distinct instances specified by the user is not empty.

Creates a test that invokes an action over the collection, which is supposed to not be supported. The test expects that an exception be thrown.

Creates a test which runs an action over the collection with a null argument. The test expects that an exception be thrown.

Gets an enumeration of test cases whose purpose is to verify the contract.

An enumeration of tests

Contract for verifying the implementation of the generic interface. Built-in verifications: ComparableCompareToThe type implements the method . The method behaves as expected agains the provided equivalence classes.OperatorGreaterThanThe type has a static "Greater Than" operator overload which behaves correctly against the provided equivalence classes. Disable that test by setting the property to false.OperatorGreaterThanOrEqualThe type has a static "Greater Than Or Equal" operator overload which behaves correctly against the provided equivalence classes. Disable that test by setting the property to false.OperatorLessThanThe type has a static "Less Than" operator overload which behaves correctly against the provided equivalence classes. Disable that test by setting the property to false.OperatorLessThanOrEqualThe type has a static "Less Than Or Equal" operator overload which behaves correctly against the provided equivalence classes. Disable that test by setting the property to false. The following example shows a simple class implementing the interface, and a test fixture which uses the comparison contract to test it.


            public class SampleComparable : IComparable<SampleComparable>
            {
                private int value;
            
                public SampleComparable(int value)
                {
                    this.value = value;
                }
            
                public int CompareTo(SampleComparable other)
                {
                    return Object.ReferenceEquals(other, null) 
                        ? Int32.MaxValue 
                        : value.CompareTo(other.value);
                }
            
                public static bool operator >=(SampleComparable left, SampleComparable right)
                {
                    return (Object.ReferenceEquals(left, null) 
                        && Object.ReferenceEquals(right, null)) 
                        || (!Object.ReferenceEquals(left, null) 
                        && (left.CompareTo(right) >= 0));
                }
            
                public static bool operator <=(SampleComparable left, SampleComparable right)
                {
                    return Object.ReferenceEquals(left, null) 
                        || (left.CompareTo(right) <= 0);
                }
            
                public static bool operator >(SampleComparable left, SampleComparable right)
                {
                    return !Object.ReferenceEquals(left, null) 
                        && (left.CompareTo(right) > 0);
                }
            
                public static bool operator <(SampleComparable left, SampleComparable right)
                {
                    return (!Object.ReferenceEquals(left, null) 
                        || !Object.ReferenceEquals(right, null)) 
                        && (Object.ReferenceEquals(left, null) 
                        || (left.CompareTo(right) < 0));
                }
            
            public class SampleComparableTest
            {
                [VerifyContract]
                public readonly IContract EqualityTests = new ComparisonContract<SampleComparable>
                {
                    ImplementsOperatorOverloads = true, // Optional (default is true)
                    EquivalenceClasses =
                    {
                        { new SampleComparable(1) },
                        { new SampleComparable(2) },
                        { new SampleComparable(3) },
                        { new SampleComparable(4) },
                        { new SampleComparable(5) }
                    }
                };
            }

Gets or sets the collection of equivalence classes of instances to feed the contract verifier.

Determines whether the verifier will evaluate the presence and the behavior of the four operator overloads "Greater Than", "Greater Than Or Equal", "Less Than", and "Less Than Or Equal". The default value is 'true'.

Gets an enumeration of test cases whose purpose is to verify the contract.

An enumeration of tests

A collection of distinct object instances. Every element represents a valid instance which is different from all the other elements in the collection (object equality). Distinct instances are used by some contract verifiers such as to check for the correct implementation of the collection interface. Use the default constructor followed by a list initializer.


            var collection = new DistinctInstanceCollection<Foo>
            {
                new Foo(1)
                new Foo(2),
                new Foo(3),
            };

Or, use the single-parameter constructor to create a collection from an pre-existing enumeration.


            var collection = new DistinctInstanceCollection<Foo>(Foo.GetThemAll());

The type of the object instances in the collection.

Gets all the instances.

Adds the specified instance to the collection.

A valid and non-null object instance.

Returns a strongly-typed enumerator that iterates through the collection.

A strongly-typed enumerator

Contract for verifying the implementation of the generic interface. Built-in verifications: ObjectEqualsThe method was overriden and behaves correctly against the provided equivalence classes.ObjectGetHashCodeThe method was overriden and behaves correctly against the provided equivalence classes.EquatableEqualsThe method is implemented and behaves as expected agains the provided equivalence classes.OperatorEqualsThe type has a static equality operator (==) overload which behaves correctly against the provided equivalence classes. Disable that test by setting the property to false.OperatorNotEqualsThe type has a static inequality operator (!=) overload which behaves correctly against the provided equivalence classes. Disable that test by setting the property to false. The following example shows a simple class implementing the interface, and a test fixture which uses the equality contract to test it.


            public class SampleEquatable : IEquatable<SampleEquatable>
            {
                private int value;
            
                public SampleEquatable(int value)
                {
                    this.value = value;
                }
            
                public override int GetHashCode()
                {
                    return value.GetHashCode();
                }
            
                public override bool Equals(object obj)
                {
                    return Equals(obj as SampleEquatable);
                }
            
                public bool Equals(SampleEquatable other)
                {
                    return !Object.ReferenceEquals(other, null) 
                        && (value == other.value);
                }
            
                public static bool operator ==(SampleEquatable left, SampleEquatable right)
                {
                    return (Object.ReferenceEquals(left, null)
                        && Object.ReferenceEquals(right, null))
                        || (!Object.ReferenceEquals(left, null) 
                        && left.Equals(right));
                }
                
                public static bool operator !=(SampleEquatable left, SampleEquatable right)
                {
                    return !(left == right);
                }
            }
            
            public class SampleEquatableTest
            {
                [VerifyContract]
                public readonly IContract EqualityTests = new EqualityContract<SampleEquatable>
                {
                    ImplementsOperatorOverloads = true, // Optional (default is true)
                    EquivalenceClasses =
                    {
                        { new SampleEquatable(1) },
                        { new SampleEquatable(2) },
                        { new SampleEquatable(3) },
                        { new SampleEquatable(4) },
                        { new SampleEquatable(5) }
                    }
                };
            }

The target tested type which implements the generic interface.

Gets or sets the collection of equivalence classes of instances to feed the contract verifier.

Determines whether the verifier will evaluate the presence and the behavior of the equality and the inequality operator overloads. The default value is true. Built-in verifications: The type has a static equality operator (==) overload which behaves correctly against the provided equivalence classes.The type has a static inequality operator (!=) overload which behaves correctly against the provided equivalence classes.

Gets an enumeration of test cases whose purpose is to verify the contract.

An enumeration of tests

Contains a collection of equivalent object instances. All the elements of the collection should be equal together, in the sense of the local implementation of an equality contract () or a comparison contract (). Equivalent classes are used by some contract verifiers such as to check for the correct implementation of object equality or comparison.

The type of equivalent object instances.

Gets the collection of equivalent instances.

Returns a strongly-typed enumerator that iterates through the collection.

A strongly-typed enumerator

A collection of equivalence classes. Equivalent classes are used by some contract verifiers such as and to check for the correct implementation of object equality or comparison. Use the default constructor followed by a list initializer to create a collection of equivalence classes which contains a variable number of object instances.


            var collection = new EquivalenceClassCollection<Foo>
            {
                { new Foo(1), new Foo("One") },
                { new Foo(2), new Foo("Two") },
                { new Foo(3), new Foo("Three") }
            };

Use the single-parameter constructor to create a collection of equivalence classes which contains one single object instance each.


            var collection = new EquivalenceClassCollection<Foo>(new Foo(1), new Foo(2), new Foo(3));

The type of equivalent object instances.

Gets the equivalence classes.

Adds to the collection a new equivalence class which contains the specified objects.

An array of equivalent instances.

Returns a strongly-typed enumerator that iterates through the collection.

A strongly-typed enumerator

Contract for verifying the implementation of a custom exception type. Built-in verifications: HasSerializableAttributeThe exception type has the attribute. Disable that test by settings the property to false.HasSerializationConstructorThe exception type has a protected serialization constructor similar to . Disable that test by settings the property to false.IsDefaultConstructorWellDefinedThe exception type has a default parameter-less constructor. When the property is set to true as well, the method verifies that the properties of the exception are preserved during a roundtrip serialization. Disable the test by settings the property to false. IsMessageConstructorWellDefinedThe exception type has single argument constructor for the message. When the property is set to true as well, the method verifies that the properties of the exception are preserved during a roundtrip serialization. Disable the test by settings the property to false. IsMessageAndInnerExceptionConstructorWellDefinedThe exception type has two parameters constructor for the message and an inner exception. When the property is set to true as well, the method verifies that the properties of the exception are preserved during a roundtrip serialization. Disable the test by settings the property to false. The following example shows a simple custom exception class with some basic serialization support, and a test fixture which uses the exception contract to test it.


            [Serializable]
            public class SampleException : Exception, ISerializable
            {
                public SampleException()
                {
                }
            
                public SampleException(string message)
                    : base(message)
                {
                }
            
                public SampleException(string message, Exception innerException)
                    : base(message, innerException)
                {
                }
            
                protected SampleException(SerializationInfo info, StreamingContext context)
                    : base(info, context)
                {
                }
            
                public override void GetObjectData(SerializationInfo info, StreamingContext context)
                {
                    base.GetObjectData(info, context);
                }
            }
            
            public class SampleExceptionTest
            {
                [VerifyContract]
                public readonly IContract ExceptionTests = new ExceptionContract<SampleException>()
                {
                    ImplementsSerialization = true, // Optional (default is true)
                    ImplementsStandardConstructors = true // Optional (default is true)
                };
            }

The target custom exception type.

Determines whether the verifier will check for the serialization support. The default value is 'true'. Built-in verifications: The exception implements the interface.The exception has the attribute.The exception type has a protected serialization constructor similar to .

Determines whether the verifier will check for the presence of the recommended standard constructors. The default value is 'true'. Built-in verifications: The exception has a default parameter-less constructor.The exception has a single parameter constructor for the message.The exception two parameters constructor for the message and an inner exception.

Gets an enumeration of test cases whose purpose is to verify the contract.

An enumeration of tests

Performs round-trip serialization of the exception and returns the result.

The exception instance. The instance produced after serialization and deserialization

Contract for verifying the implementation of an immutable type. Built-in verifications: AreReadOnlyFieldsAll the public and non-public instance fields are marked as read only. The evaluation is made recursively on the field types too.HasNoPublicPropertySetterThe type does not have any public property setter. The evaluation is made recursively on the property types too. The following example shows a simple immutable class with all the instance fields marked as read only, and a test fixture which invokes the immutability contract to test the class.


             public class SampleImmutable
             {
                 private readonly int number;
                 private readonly string text;
             
                 public SampleImmutable(int number, string text)
                 {
                     this.number = number;
                     this.text = text;
                 }
             }
            
             public class SampleImmutableTest
             {
                 [VerifyContract]
                 public readonly IContract ImmutabilityTests = new ImmutabilityContract<SampleImmutable>();
             }

The target immutable type.

Gets an enumeration of test cases whose purpose is to verify the contract.

An enumeration of tests

Contract for verifying the implementation of the generic interface. Since the generic interface is a descendant of the generic interface, the contract verifier has the same tests as the contract verifier, plus the following built-in verifications: InsertShouldThrowExceptionThe read-only collection throws an exception when the method is called. The test is not run when the contract property inherited from , is set to 'false'. RemoveAtShouldThrowExceptionThe read-only collection throws an exception when the method is called. The test is not run when the contract property inherited from , is set to 'false'. IndexerSetShouldThrowExceptionThe read-only collection throws an exception when the setter of the indexer is called. The test is not run when the contract property inherited from , is set to 'false'. InsertNullArgumentThe collection throwns a when the method is called with a null reference item. The test is not run when the contract property inherited from , is set to 'true'. IndexOfNullArgumentThe collection throwns a when the method is called with a null reference item. The test is not run when the contract property inherited from , is set to 'true'. IndexerSetNullArgumentThe collection throwns a when the setter of the indexer is called with a null reference item. The test is not run when the contract property inherited from , is set to 'true'. InsertItems The collection handles correctly with the insertion of new items. The method and the property are expected to return suitable results as well. The case of duplicate items (object equality) is tested too; according to the value of contract property , inherited from . The test is not run when the contract property inherited from , is set to 'true'. InsertItemsAtInvalidIndex The collection handles correctly with the insertion of new items at an invalid index. The method should throw an when called with a negative index or with an index greater than the number of items in the list. The test is not run when the contract property inherited from , is set to 'true'. RemoveItemsAt The collection handles correctly with the removal of items at specific indexes. The method and the property are expected to return suitable results as well. The test is not run when the contract property inherited from , is set to 'true'. RemoveItemsAtInvalidIndex The collection handles correctly with the removal of items at an invalid index. The method should throw an when called with a negative index or with an index greater than the number of items in the list. The test is not run when the contract property inherited from , is set to 'true'. GetItemsAtInvalidIndex The collection handles correctly with the retrieval of items at an invalid index. The indexer should throw an when called with a negative index or with an index greater than the number of items in the list. GetSetItemsWithIndexer Setting and getting items by using the indexer property works as expected. The test is not run when the contract property inherited from , is set to 'true'. IndexOfItem The retrieval of the index of an item in the collection works as expected, and the index can be used effectively to get the item with the getter of the indexer property.

The type of the collection implementing . The type of items contained by the list.

Verifies that a contract has been satisfied. The contract is described by a value assigned to a field of the test fixture.

Returns true if this is a primary pattern. A primary pattern is a pattern that defines the ultimate purpose of a code element and the nature of the tests or test parameters that are produced from it. Consequently the primary pattern is the only one on which the method will be called. Each code element may have at most one primary pattern. It is an error for a code element to have more than one associated primary pattern. If a code element does not have an associated primary pattern, its containing test may choose to apply default processing to it instead. For example, the containing test may give an opportunity to patterns associated with the code element to consume a test method parameter but will revert to default behavior if no primary patterns explicitly claim it. Non-primary patterns still play a very important part in the construction of the test model. Non-primary patterns may implement the method to decorate tests and test parameters declared by the primary pattern.

Initializes a test for a contract verifier field after it has been added to the test model.

The field scope The field

Returns true if the code element represents a test.

The evaluator The code element True if the code element represents a test

Establishes the semantics of the contract verifier.

The test builder The field

Verifies that the attribute is being used correctly.

The containing scope The field Thrown if the attribute is being used incorrectly

Describes a contract that can be verified.

Gets an enumeration of test cases whose purpose is to verify the contract.

The context of execution. An enumeration of tests

Execution context of a contract verification test. This class cannot be inherited.

Gets the code element for the contrat read-only field.

Gets an artificial stack trace data that points to the contrat read-only field.

An artificial stack trace data that points to the contrat read-only field.

Indicates that a reflection operation performed by failed.

Helps to test non-public classes and class members.

Create Instance

Full assembly path. Type Name such as (System.String) Newly created object.

Create Instance

Full assembly path. Type Name such as (System.String) Constructor parameters. Newly created object.

Get public, non-public, or static field value.

Object where field is defined. Field name. Field value

Get field value.

Specify field access modifier. Object where field is defined. Field name. Field value

Get field value.

Specify field access modifier. Object where field is defined. Field name. Specify if need to look in Base classes. Field value

Get public, non-public, or static field value.

Field name. Field value

Get field value.

Field name. Specify field access modifier. Field value

Get field value.

Field name. Specify field access modifier. Specify if need to look in Base classes. Field value

Get Property Value

Object where property is defined. Property Name. Property Value.

Get Property Value

Specify property access modifier. Object that has the property. Property Name. Property Value.

Get Property Value

Specify property access modifier. Object that has the property. Property Name. Set to true if need look for the property in base classes. Property Value.

Get Property Value

Property Name. Property Value.

Get Property Value

Specify property access modifier. Property Name. Property Value.

Get Property Value

Specify property access modifier. Property Name. Specify if need to look in Base classes. Property Value.

Execute a NonPublic method with arguments on a object

Object where method is defined. Method to call The object the method should return.

Execute a NonPublic method with arguments on a object

Object where method is defined. Method to call Method's parameters. The object the method should return.

Execute a NonPublic method with arguments on a object

Specify method access modifier. Object where method is defined. Method to call Method's parameters. The object the method should return.

Execute a NonPublic method with arguments on a object

Specify method access modifier. Object where method is defined. Method to call Speicifies if to search for the method in the base classes or not. Method's parameters. The object the method should return.

Execute a NonPublic method with arguments on a object

Method to call The object the method should return.

Execute a NonPublic method with arguments on a object

Method to call Method's parameters. The object the method should return.

Execute a NonPublic method with arguments on a object

Method to call Specify method access modifier. Method's parameters. The object the method should return.

Set field value.

Object where field is defined. Field Name. Field Value.

Set field value.

Specify field access modifier. Object where field is defined. Field Name. Field Value.

Set field value.

Specify field access modifier. Object where field is defined. Field Name. Field Value. Specify if need to look in Base classes.

Set field value.

Field Name. Field Value.

Set field value.

Field Name. Field Value. Specify field access modifier.

Set Property value.

Object where property is defined. Property Name. Property Value.

Set Property value.

Specify property access modifier. Object where property is defined. Property Name. Property Value.

Set Property value.

Specify property access modifier. Object where property is defined. Property Name. Property Value. Set to true if need look for the property in base classes.

Set Property value.

Property Name. Property Value.

Set Property value.

Specify property access modifier. Property Name. Property Value.

Access modifier of a class or class member.

public

protected, internal, private

static

default that includes public, protected, internal, private, and static

Member types of a class.

Method

Field or variable

Property