nunit 2.5.1.9189 → 2.5.2.9222

data/docs/throwsConstraint.html

@@ -46,11 +46,15 @@ ThrowsNothingConstraint()
 <h4>Syntax</h4>
 <div class="code"><pre>
 Throws.Exception
+Throws.TargetInvocationException
+Throws.ArgumentException
+Throws.InvalidOperationException
 Throws.TypeOf(Type expectedType)
 Throws.TypeOf&lt;T&gt;()
 Throws.InstanceOf(Type expectedType)
 Throws.InstanceOf&lt;T&gt;()
 Throws.Nothing
+Throws.InnerException
 </pre></div>
 
 <h4>Examples of Use</h4>
@@ -63,6 +67,11 @@ Assert.That( new TestDelegate(SomeMethod),
 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, 
@@ -72,6 +81,10 @@ Assert.That( SomeMethod,
 Assert.That( SomeMethod, 
   Throws.TypeOf&lt;ArgumentException&gt;()
     .With.Property("Parameter").EqualTo("myParam"));
+Assert.That( SomeMethod, Throws.ArgumentException );
+Assert.That( SomeMethod, 
+  Throws.TargetInvocationException
+    .With.InnerException.TypeOf&lt;ArgumentException&gt;());
 </pre></div>
 
 <h4>Notes</h4>
@@ -85,6 +98,13 @@ Assert.That( SomeMethod,
 <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>
 
 
@@ -94,7 +114,7 @@ Assert.That( SomeMethod,
 <!-- Submenu -->
 <div id="subnav">
 <ul>
-<li><a href="index.html">NUnit 2.5.1</a></li>
+<li><a href="index.html">NUnit 2.5.2</a></li>
 <ul>
 <li><a href="getStarted.html">Getting&nbsp;Started</a></li>
 <li><a href="assertions.html">Assertions</a></li>

data/docs/timeout.html

@@ -27,9 +27,23 @@
 <h3>TimeoutAttribute (NUnit 2.5)</h3>
 
 <p>The <b>TimeoutAttribute</b> is used to specify a timeout value in milliseconds
-   for a test case. It may also be speciried on a fixture or assembly, in which
-   case it indicates the default timeout for any subordinate test cases.
+   for a test case. If the test case runs longer than the time specified it
+   is immediately cancelled and reported as a failure, with a message 
+   indicating that the timeout was exceeded.
    
+<p>The attribute may also be specified on a fixture or assembly, in which
+   case it indicates the default timeout for any subordinate test cases.
+
+<h4>Example</h4>
+
+<div class="code"><pre>
+[Test, Timeout(2000)]
+public void PotentiallyLongRunningTest()
+{
+    ...
+}
+</pre></div>
+
 <h4>See Also...</h4>
 <ul>
 <li><a href="maxtime.html">MaxtimeAttribute</a></ul>
@@ -40,7 +54,7 @@
 <!-- Submenu -->
 <div id="subnav">
 <ul>
-<li><a href="index.html">NUnit 2.5.1</a></li>
+<li><a href="index.html">NUnit 2.5.2</a></li>
 <ul>
 <li><a href="getStarted.html">Getting&nbsp;Started</a></li>
 <li><a href="assertions.html">Assertions</a></li>

data/docs/typeAsserts.html

@@ -89,7 +89,7 @@ Assert.IsNotAssignableFrom<T>( object actual,
 <!-- Submenu -->
 <div id="subnav">
 <ul>
-<li><a href="index.html">NUnit 2.5.1</a></li>
+<li><a href="index.html">NUnit 2.5.2</a></li>
 <ul>
 <li><a href="getStarted.html">Getting&nbsp;Started</a></li>
 <li><a href="assertions.html">Assertions</a></li>

data/docs/typeConstraints.html

@@ -59,7 +59,7 @@ Expect( "Hello", AssignableFrom(typeOf(string)));
 <!-- Submenu -->
 <div id="subnav">
 <ul>
-<li><a href="index.html">NUnit 2.5.1</a></li>
+<li><a href="index.html">NUnit 2.5.2</a></li>
 <ul>
 <li><a href="getStarted.html">Getting&nbsp;Started</a></li>
 <li><a href="assertions.html">Assertions</a></li>

data/docs/upgrade.html

@@ -64,7 +64,7 @@ in order for your tests to load correctly.
 <!-- Submenu -->
 <div id="subnav">
 <ul>
-<li><a href="index.html">NUnit 2.5.1</a></li>
+<li><a href="index.html">NUnit 2.5.2</a></li>
 <ul>
 <li><a href="getStarted.html">Getting&nbsp;Started</a></li>
 <ul>

data/docs/utilityAsserts.html

@@ -85,7 +85,7 @@ public void AssertStringContains( string expected, string actual,
 <!-- Submenu -->
 <div id="subnav">
 <ul>
-<li><a href="index.html">NUnit 2.5.1</a></li>
+<li><a href="index.html">NUnit 2.5.2</a></li>
 <ul>
 <li><a href="getStarted.html">Getting&nbsp;Started</a></li>
 <li><a href="assertions.html">Assertions</a></li>

data/docs/valueSource.html

@@ -58,6 +58,22 @@ provide the arguments. It should have the following characteristics:
 <li>
 </ul>
 
+<h3>Order of Execution</h3>
+
+<p>In NUnit 2.5, individual test cases are sorted alphabetically and executed in
+   that order. With NUnit 2.5.1, the individual cases are not sorted, but are
+   executed in the order in which NUnit discovers them. This order does <b>not</b>
+   follow the lexical order of the attributes and will often vary between different
+   compilers or different versions of the CLR.
+   
+<p>As a result, when <b>ValueSourceAttribute</b> appears multiple times on a 
+   parameter or when other data-providing attributes are used in combination with 
+   <b>ValueSourceAttribute</b>, the order of the arguments is undefined.
+
+<p>However, when a single <b>ValueSourceAttribute</b> is used by itself, 
+   the order of the arguments follows exactly the order in which the data 
+   is returned from the source.
+   
 <h3>Note on Object Construction</h3>
 
 <p>NUnit locates the test cases at the time the tests are loaded, creates
@@ -77,7 +93,7 @@ themselves.
 <!-- Submenu -->
 <div id="subnav">
 <ul>
-<li><a href="index.html">NUnit 2.5.1</a></li>
+<li><a href="index.html">NUnit 2.5.2</a></li>
 <ul>
 <li><a href="getStarted.html">Getting&nbsp;Started</a></li>
 <li><a href="assertions.html">Assertions</a></li>

data/docs/values.html

@@ -58,6 +58,22 @@ public void MyTest(
 }
 </pre></div>
 
+<h3>Order of Execution</h3>
+
+<p>In NUnit 2.5, individual test cases are sorted alphabetically and executed in
+   that order. With NUnit 2.5.1, the individual cases are not sorted, but are
+   executed in the order in which NUnit discovers them. This order does <b>not</b>
+   follow the lexical order of the attributes and will often vary between different
+   compilers or different versions of the CLR.
+   
+<p>As a result, when <b>ValuesAttribute</b> appears multiple times on a 
+   parameter or when other data-providing attributes are used in combination with 
+   <b>ValuesAttribute</b>, the order of the argument data is undefined.
+
+<p>However, when a single <b>ValuesAttribute</b> is used by itself, 
+   the order of the data follows exactly the order in which the it is 
+   specified in the attribute constructor. 
+   
 <h4>See also...</h4>
 <ul>
 <li><a href="range.html">RangeAttribute</a><li><a href="random.html">RandomAttribute</a><li><a href="sequential.html">SequentialAttribute</a><li><a href="combinatorial.html">CombinatorialAttribute</a><li><a href="pairwise.html">PairwiseAttribute</a></ul>
@@ -67,7 +83,7 @@ public void MyTest(
 <!-- Submenu -->
 <div id="subnav">
 <ul>
-<li><a href="index.html">NUnit 2.5.1</a></li>
+<li><a href="index.html">NUnit 2.5.2</a></li>
 <ul>
 <li><a href="getStarted.html">Getting&nbsp;Started</a></li>
 <li><a href="assertions.html">Assertions</a></li>

data/docs/vsSupport.html

@@ -107,7 +107,7 @@ specified in the VS project.</p>
 <!-- Submenu -->
 <div id="subnav">
 <ul>
-<li><a href="index.html">NUnit 2.5.1</a></li>
+<li><a href="index.html">NUnit 2.5.2</a></li>
 <ul>
 <li><a href="getStarted.html">Getting&nbsp;Started</a></li>
 <li><a href="assertions.html">Assertions</a></li>

data/lib/net-1.1/framework/nunit.framework.xml

@@ -1410,6 +1410,12 @@
             constraint to the Message property of the object being tested.
             </summary>
         </member>
+        <member name="P:NUnit.Framework.Constraints.ConstraintExpression.InnerException">
+            <summary>
+            Returns a new ConstraintExpression, which will apply the following
+            constraint to the InnerException property of the object being tested.
+            </summary>
+        </member>
         <member name="P:NUnit.Framework.Constraints.ConstraintExpression.With">
             <summary>
             With is currently a NOP - reserved for future use.
@@ -2929,6 +2935,12 @@
             constraint to the Message property of the object being tested.
             </summary>
         </member>
+        <member name="P:NUnit.Framework.Constraints.ConstraintFactory.InnerException">
+            <summary>
+            Returns a new ConstraintExpression, which will apply the following
+            constraint to the InnerException property of the object being tested.
+            </summary>
+        </member>
         <member name="P:NUnit.Framework.Constraints.ConstraintFactory.Null">
             <summary>
             Returns a constraint that tests for null
@@ -3849,6 +3861,18 @@
             Gets the description of the test
             </summary>
         </member>
+        <member name="P:NUnit.Framework.ITestCaseData.Ignored">
+            <summary>
+            Gets a value indicating whether this <see cref="T:NUnit.Framework.ITestCaseData"/> is ignored.
+            </summary>
+            <value><c>true</c> if ignored; otherwise, <c>false</c>.</value>
+        </member>
+        <member name="P:NUnit.Framework.ITestCaseData.IgnoreReason">
+            <summary>
+            Gets the ignore reason.
+            </summary>
+            <value>The ignore reason.</value>
+        </member>
         <member name="F:NUnit.Framework.TestCaseData.arguments">
             <summary>
             The argument list to be provided to the test
@@ -3885,6 +3909,16 @@
             to tests without requiring the class to change.
             </summary>
         </member>
+        <member name="F:NUnit.Framework.TestCaseData.isIgnored">
+            <summary>
+            If true, indicates that the test case is to be ignored
+            </summary>
+        </member>
+        <member name="F:NUnit.Framework.TestCaseData.ignoreReason">
+            <summary>
+            The reason for ignoring a test case
+            </summary>
+        </member>
         <member name="M:NUnit.Framework.TestCaseData.#ctor(System.Object[])">
             <summary>
             Initializes a new instance of the <see cref="T:TestCaseData"/> class.
@@ -3978,6 +4012,19 @@
             <param name="propValue"></param>
             <returns></returns>
         </member>
+        <member name="M:NUnit.Framework.TestCaseData.Ignore">
+            <summary>
+            Ignores this TestCase.
+            </summary>
+            <returns></returns>
+        </member>
+        <member name="M:NUnit.Framework.TestCaseData.Ignore(System.String)">
+            <summary>
+            Ignores this TestCase, specifying the reason.
+            </summary>
+            <param name="reason">The reason.</param>
+            <returns></returns>
+        </member>
         <member name="P:NUnit.Framework.TestCaseData.Arguments">
             <summary>
             Gets the argument list to be provided to the test
@@ -4008,6 +4055,18 @@
             Gets the description of the test
             </summary>
         </member>
+        <member name="P:NUnit.Framework.TestCaseData.Ignored">
+            <summary>
+            Gets a value indicating whether this <see cref="T:NUnit.Framework.ITestCaseData"/> is ignored.
+            </summary>
+            <value><c>true</c> if ignored; otherwise, <c>false</c>.</value>
+        </member>
+        <member name="P:NUnit.Framework.TestCaseData.IgnoreReason">
+            <summary>
+            Gets the ignore reason.
+            </summary>
+            <value>The ignore reason.</value>
+        </member>
         <member name="P:NUnit.Framework.TestCaseData.Categories">
             <summary>
             Gets a list of categories associated with this test.
@@ -4119,6 +4178,12 @@
             constraint to the Message property of the object being tested.
             </summary>
         </member>
+        <member name="P:NUnit.Framework.Has.InnerException">
+            <summary>
+            Returns a new ConstraintExpression, which will apply the following
+            constraint to the InnerException property of the object being tested.
+            </summary>
+        </member>
         <member name="T:NUnit.Framework.List">
             <summary>
             The List class is a helper class with properties and methods
@@ -4283,6 +4348,22 @@
             </summary>
             <value>The name of the test.</value>
         </member>
+        <member name="P:NUnit.Framework.TestCaseAttribute.Ignore">
+            <summary>
+            Gets or sets the ignored status of the test
+            </summary>
+        </member>
+        <member name="P:NUnit.Framework.TestCaseAttribute.Ignored">
+            <summary>
+            Gets or sets the ignored status of the test
+            </summary>
+        </member>
+        <member name="P:NUnit.Framework.TestCaseAttribute.IgnoreReason">
+            <summary>
+            Gets the ignore reason.
+            </summary>
+            <value>The ignore reason.</value>
+        </member>
         <member name="T:NUnit.Framework.SuccessException">
             <summary>
             Thrown when an assertion failed.
@@ -4619,6 +4700,57 @@
             <param name="expectedExceptionType">The exception Type expected</param>
             <param name="code">A TestSnippet delegate</param>
         </member>
+        <member name="M:NUnit.Framework.Assert.Catch(NUnit.Framework.TestDelegate,System.String,System.Object[])">
+            <summary>
+            Verifies that a delegate throws an exception when called
+            and returns it.
+            </summary>
+            <param name="code">A TestDelegate</param>
+            <param name="message">The message that will be displayed on failure</param>
+            <param name="args">Arguments to be used in formatting the message</param>
+        </member>
+        <member name="M:NUnit.Framework.Assert.Catch(NUnit.Framework.TestDelegate,System.String)">
+            <summary>
+            Verifies that a delegate throws an exception when called
+            and returns it.
+            </summary>
+            <param name="code">A TestDelegate</param>
+            <param name="message">The message that will be displayed on failure</param>
+        </member>
+        <member name="M:NUnit.Framework.Assert.Catch(NUnit.Framework.TestDelegate)">
+            <summary>
+            Verifies that a delegate throws an exception when called
+            and returns it.
+            </summary>
+            <param name="code">A TestDelegate</param>
+        </member>
+        <member name="M:NUnit.Framework.Assert.Catch(System.Type,NUnit.Framework.TestDelegate,System.String,System.Object[])">
+            <summary>
+            Verifies that a delegate throws an exception of a certain Type
+            or one derived from it when called and returns it.
+            </summary>
+            <param name="expectedExceptionType">The expected Exception Type</param>
+            <param name="code">A TestDelegate</param>
+            <param name="message">The message that will be displayed on failure</param>
+            <param name="args">Arguments to be used in formatting the message</param>
+        </member>
+        <member name="M:NUnit.Framework.Assert.Catch(System.Type,NUnit.Framework.TestDelegate,System.String)">
+            <summary>
+            Verifies that a delegate throws an exception of a certain Type
+            or one derived from it when called and returns it.
+            </summary>
+            <param name="expectedExceptionType">The expected Exception Type</param>
+            <param name="code">A TestDelegate</param>
+            <param name="message">The message that will be displayed on failure</param>
+        </member>
+        <member name="M:NUnit.Framework.Assert.Catch(System.Type,NUnit.Framework.TestDelegate)">
+            <summary>
+            Verifies that a delegate throws an exception of a certain Type
+            or one derived from it when called and returns it.
+            </summary>
+            <param name="expectedExceptionType">The expected Exception Type</param>
+            <param name="code">A TestDelegate</param>
+        </member>
         <member name="M:NUnit.Framework.Assert.DoesNotThrow(NUnit.Framework.TestDelegate,System.String,System.Object[])">
             <summary>
             Verifies that a delegate does not throw an exception
@@ -6775,6 +6907,18 @@
             The arguments originally provided to the attribute
             </summary>
         </member>
+        <member name="P:NUnit.Framework.TestFixtureAttribute.Ignore">
+            <summary>
+            Gets or sets a value indicating whether this <see cref="T:NUnit.Framework.TestFixtureAttribute"/> should be ignored.
+            </summary>
+            <value><c>true</c> if ignore; otherwise, <c>false</c>.</value>
+        </member>
+        <member name="P:NUnit.Framework.TestFixtureAttribute.IgnoreReason">
+            <summary>
+            Gets or sets the ignore reason. May set Ignored as a side effect.
+            </summary>
+            <value>The ignore reason.</value>
+        </member>
         <member name="T:NUnit.Framework.CollectionAssert">
             <summary>
             A set of Assert methods operationg on one or more collections
@@ -7289,16 +7433,17 @@
         </member>
         <member name="T:NUnit.Framework.TimeoutAttribute">
             <summary>
-            Marks a test with a timeout value in milliseconds. The
-            test will be run in a separate thread and cancelled if
-            the timeout is exceeded.
+            WUsed on a method, marks the test with a timeout value in milliseconds. 
+            The test will be run in a separate thread and is cancelled if the timeout 
+            is exceeded. Used on a method or assembly, sets the default timeout 
+            for all contained test methods.
             </summary>
         </member>
         <member name="M:NUnit.Framework.TimeoutAttribute.#ctor(System.Int32)">
             <summary>
             Construct a TimeoutAttribute given a time in milliseconds
             </summary>
-            <param name="timeout"></param>
+            <param name="timeout">The timeout value in milliseconds</param>
         </member>
         <member name="T:NUnit.Framework.RequiresSTAAttribute">
             <summary>
@@ -8633,6 +8778,26 @@
             Creates a constraint specifying an expected exception
             </summary>
         </member>
+        <member name="P:NUnit.Framework.Throws.InnerException">
+            <summary>
+            Creates a constraint specifying an exception with a given InnerException
+            </summary>
+        </member>
+        <member name="P:NUnit.Framework.Throws.TargetInvocationException">
+            <summary>
+            Creates a constraint specifying an expected TargetInvocationException
+            </summary>
+        </member>
+        <member name="P:NUnit.Framework.Throws.ArgumentException">
+            <summary>
+            Creates a constraint specifying an expected TargetInvocationException
+            </summary>
+        </member>
+        <member name="P:NUnit.Framework.Throws.InvalidOperationException">
+            <summary>
+            Creates a constraint specifying an expected TargetInvocationException
+            </summary>
+        </member>
         <member name="P:NUnit.Framework.Throws.Nothing">
             <summary>
             Creates a constraint specifying that no exception is thrown
@@ -8670,18 +8835,6 @@
             guaranteed to be called, even if an exception is thrown.
             </summary>
         </member>
-        <member name="T:NUnit.Framework.Catch">
-            <summary>
-            The Catch class is used to capture an exception.
-            </summary>
-        </member>
-        <member name="M:NUnit.Framework.Catch.Exception(NUnit.Framework.TestDelegate)">
-            <summary>
-            Capture any exception that is thrown by the delegate
-            </summary>
-            <param name="code">A TestDelegate</param>
-            <returns>The exception thrown, or null</returns>
-        </member>
         <member name="T:NUnit.Framework.Text">
             <summary>
             Helper class with static methods used to supply constraints
@@ -8754,6 +8907,17 @@
             </summary>
             <param name="milliseconds">The maximum elapsed time in milliseconds</param>
         </member>
+        <member name="T:NUnit.Framework.SetUICultureAttribute">
+            <summary>
+            Summary description for SetUICultureAttribute.
+            </summary>
+        </member>
+        <member name="M:NUnit.Framework.SetUICultureAttribute.#ctor(System.String)">
+            <summary>
+            Construct given the name of a culture
+            </summary>
+            <param name="culture"></param>
+        </member>
         <member name="T:NUnit.Framework.DirectoryAssert">
             <summary>
             Summary description for DirectoryAssert