<!-- saved from url=(0014)about:internet --><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
<html>
<!-- Standard Head Part -->
<head>
<title>NUnit - TestDecorators</title>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<meta http-equiv="Content-Language" content="en-US">
<meta name="norton-safeweb-site-verification" content="tb6xj01p4hgo5x-8wscsmq633y11-e6nhk-bnb5d987bseanyp6p0uew-pec8j963qlzj32k5x9h3r2q7wh-vmy8bbhek5lnpp5w4p8hocouuq39e09jrkihdtaeknua" />
<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">
<h3>TestDecorators (NUnit 2.4)</h3>
<h4>Purpose</h4>
<p>TestDecorators are able to modify a test after it has been constructed.
<h4>Extension Point</h4>
<p>Addins use the host to access this extension point by name:
<pre class="prettyprint">
IExtensionPoint testDecorators = host.GetExtensionPoint( "TestDecorators" );</pre>
<h4>Interface</h4>
<p>The extension object passed to Install must implement the ITestDecorator interface:
<pre class="prettyprint">
public interface ITestDecorator
{
Test Decorate( Test test, MemberInfo member );
}
</pre>
<p>The Decorate method may do several things, depending on what it needs
to accomplish:
<ol>
<li>Return test unmodified
<li>Modify properties of the test object and return it
<li>Replace test with another object, either discarding the
original or aggregating it in the new test.
</ol>
<p>Depending on what the decorator does, it may need to run
ahead of other decorators or after them. Decorators should
be installed using the Install method overload that takes
a priority. The priorities range from 1 to 9 and decorators
with lower priority values are installed first. The following
standard values are defined for use if desired:
<ul>
<li>DecoratorPriority.Default = 0
<li>DecoratorPriority.First = 1
<li>DecoratorPriority.Normal = 5
<li>DecoratorPriority.Last = 9
</ul>
</div>
<!-- Submenu -->
<div id="subnav">
<ul>
<li><a href="index.html">NUnit 2.6.4</a></li>
<ul>
<li><a href="getStarted.html">Getting Started</a></li>
<li><a href="writingTests.html">Writing Tests</a></li>
<li><a href="runningTests.html">Running Tests</a></li>
<li><a href="extensibility.html">Extensibility</a></li>
<ul>
<li><a href="customConstraints.html">Custom Constraints</a></li>
<li><a href="nunitAddins.html">NUnit Addins</a></li>
<ul>
<li><a href="suiteBuilders.html">SuiteBuilders</a></li>
<li><a href="testcaseBuilders.html">TestcaseBuilders</a></li>
<li id="current"><a href="testDecorators.html">TestDecorators</a></li>
<li><a href="testcaseProviders.html">TestcaseProviders</a></li>
<li><a href="datapointProviders.html">DatapointProviders</a></li>
<li><a href="eventListeners.html">EventListeners</a></li>
</ul>
<li><a href="extensionTips.html">Tips for Extenders</a></li>
</ul>
<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>
<li><a href="vsTestAdapter.html">NUnit Test Adapter</a></li>
<ul>
<li><a href="vsTestAdapterLicense.html">License</a></li>
<li><a href="vsTestAdapterReleaseNotes.html">Release Notes</a></li>
</ul>
<li><a href="&r=2.6.4.html"></a></li>
<li><a href="&r=2.6.4.html"></a></li>
</ul>
</div>
<!-- End of Submenu -->
<!-- Standard Footer for NUnit.org -->
<!-- public_html/nunit/footer.php -->
<div id="footer">
Copyright © 2002-2014 NUnit.org. All Rights Reserved.
</div>
<!-- End of Footer -->
<script src="https://google-code-prettify.googlecode.com/svn/loader/run_prettify.js?skin=desert"></script>
</body>
</html>
