diff options
Diffstat (limited to 'tools/NUnit/doc/throwsConstraint.html')
| -rw-r--r-- | tools/NUnit/doc/throwsConstraint.html | 156 |
1 files changed, 156 insertions, 0 deletions
diff --git a/tools/NUnit/doc/throwsConstraint.html b/tools/NUnit/doc/throwsConstraint.html new file mode 100644 index 0000000..52cc0f6 --- /dev/null +++ b/tools/NUnit/doc/throwsConstraint.html @@ -0,0 +1,156 @@ +<!-- saved from url=(0014)about:internet --><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"> +<html> +<!-- Standard Head Part --> +<head> +<title>NUnit - ThrowsConstraint</title> +<meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> +<meta http-equiv="Content-Language" content="en-US"> +<link rel="stylesheet" type="text/css" href="nunit.css"> +<link rel="shortcut icon" href="favicon.ico"> +</head> +<!-- End Standard Head Part --> + +<body> + +<!-- Standard Header for NUnit.org --> +<div id="header"> + <a id="logo" href="http://www.nunit.org"><img src="img/logo.gif" alt="NUnit.org" title="NUnit.org"></a> + <div id="nav"> + <a href="http://www.nunit.org">NUnit</a> + <a class="active" href="index.html">Documentation</a> + </div> +</div> +<!-- End of Header --> + +<div id="content"> + +<h2>Throws Constraint (NUnit 2.5)</h2> + +<p><b>ThrowsConstraint</b> is used to test that some code, represented as a delegate, +throws a particular exception. It may be used alone, to merely test the type +of constraint, or with an additional constraint to be applied to the exception +specified as an argument. + +p>The related <b>ThrowsNothingConstraint</b> simply asserts that the delegate +does not throw an exception. + +<h4>Constructors</h4> +<div class="code"><pre> +ThrowsConstraint(Type expectedType) +ThrowsConstraint<T>() +ThrowsConstraint(Type expectedType, Constraint constraint) +ThrowsConstraint<T>(Constraint constraint) +ThrowsNothingConstraint() +</pre></div> + +<h4>Syntax</h4> +<div class="code"><pre> +Throws.Exception +Throws.TargetInvocationException +Throws.ArgumentException +Throws.InvalidOperationException +Throws.TypeOf(Type expectedType) +Throws.TypeOf<T>() +Throws.InstanceOf(Type expectedType) +Throws.InstanceOf<T>() +Throws.Nothing +Throws.InnerException +</pre></div> + +<h4>Examples of Use</h4> +<div class="code"><pre> +// .NET 1.1 +Assert.That( new TestDelegate(SomeMethod), + Throws.TypeOf(typeof(ArgumentException))); +Assert.That( new TestDelegate(SomeMethod), + Throws.Exception.TypeOf(typeof(ArgumentException))); +Assert.That( new TestDelegate(SomeMethod), + Throws.TypeOf(typeof(ArgumentException)) + .With.Property("Parameter").EqualTo("myParam")); +Assert.That( new TestDelegate(SomeMethod), + Throws.ArgumentException ); +Assert.That( new TestDelegate(SomeMethod), + Throws.TargetInvocationException + .With.InnerException.TypeOf(ArgumentException)); + +// .NET 2.0 +Assert.That( SomeMethod, + Throws.TypeOf<ArgumentException>()); +Assert.That( SomeMethod, + Throws.Exception.TypeOf<ArgumentException>()); +Assert.That( SomeMethod, + Throws.TypeOf<ArgumentException>() + .With.Property("Parameter").EqualTo("myParam")); +Assert.That( SomeMethod, Throws.ArgumentException ); +Assert.That( SomeMethod, + Throws.TargetInvocationException + .With.InnerException.TypeOf<ArgumentException>()); +</pre></div> + +<h4>Notes</h4> +<ol> +<li><b>Throws.Exception</b> may be followed by further constraints, + which are applied to the exception itself as shown in the last two + examples above. It may also be used alone to verify that some + exception has been thrown, without regard to type. This is + not a recommended practice since you should normally know + what exception you are expecting. +<li><b>Throws.TypeOf</b> and <b>Throws.InstanceOf</b> are provided + as a shorter syntax for this common test. They work exactly like + the corresponding forms following <b>Throws.Exception</b>. +<li><b>Throws.TargetInvocationException/b>, <b>Throws.ArgumentException</b> + and <b>Throws.InvalidOperationException</b> provide a shortened form + for some common exceptions. +<li>Used alone, <b>Throws.InnerException</b> simply tests the InnerException + value of the thrown exception. More commonly, it will be used in + combination with a test for the type of the outer exception as shown + in the examples above. +</ol> + + + +</div> + +<!-- Submenu --> +<div id="subnav"> +<ul> +<li><a href="index.html">NUnit 2.5.5</a></li> +<ul> +<li><a href="getStarted.html">Getting Started</a></li> +<li><a href="assertions.html">Assertions</a></li> +<li><a href="constraintModel.html">Constraints</a></li> +<ul> +<li><a href="equalConstraint.html">Equal Constraint</a></li> +<li><a href="sameasConstraint.html">SameAs Constraint</a></li> +<li><a href="conditionConstraints.html">Condition Constraints</a></li> +<li><a href="comparisonConstraints.html">Comparison Constrants</a></li> +<li><a href="pathConstraints.html">Path Constraints</a></li> +<li><a href="typeConstraints.html">Type Constraints</a></li> +<li><a href="stringConstraints.html">String Constraints</a></li> +<li><a href="collectionConstraints.html">Collection Constraints</a></li> +<li><a href="propertyConstraint.html">Property Constraint</a></li> +<li id="current"><a href="throwsConstraint.html">Throws Constraint</a></li> +<li><a href="compoundConstraints.html">Compound Constraints</a></li> +<li><a href="delayedConstraint.html">Delayed Constraint</a></li> +<li><a href="listMapper.html">List Mapper</a></li> +</ul> +<li><a href="attributes.html">Attributes</a></li> +<li><a href="runningTests.html">Running Tests</a></li> +<li><a href="extensibility.html">Extensibility</a></li> +<li><a href="releaseNotes.html">Release Notes</a></li> +<li><a href="samples.html">Samples</a></li> +<li><a href="license.html">License</a></li> +</ul> +</ul> +</div> +<!-- End of Submenu --> + + +<!-- Standard Footer for NUnit.org --> +<div id="footer"> + Copyright © 2009 Charlie Poole. All Rights Reserved. +</div> +<!-- End of Footer --> + +</body> +</html> |