[1146] | 1 | <!-- saved from url=(0014)about:internet --><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
|
---|
| 2 | <html>
|
---|
| 3 | <!-- Standard Head Part -->
|
---|
| 4 | <head>
|
---|
| 5 | <title>NUnit - SettingsDialog</title>
|
---|
| 6 | <meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
---|
| 7 | <meta http-equiv="Content-Language" content="en-US">
|
---|
| 8 | <link rel="stylesheet" type="text/css" href="nunit.css">
|
---|
| 9 | <link rel="shortcut icon" href="favicon.ico">
|
---|
| 10 | </head>
|
---|
| 11 | <!-- End Standard Head Part -->
|
---|
| 12 |
|
---|
| 13 | <body>
|
---|
| 14 |
|
---|
| 15 | <!-- Standard Header for NUnit.org -->
|
---|
| 16 | <div id="header">
|
---|
| 17 | <a id="logo" href="http://www.nunit.org"><img src="img/logo.gif" alt="NUnit.org" title="NUnit.org"></a>
|
---|
| 18 | <div id="nav">
|
---|
| 19 | <a href="http://www.nunit.org">NUnit</a>
|
---|
| 20 | <a class="active" href="index.html">Documentation</a>
|
---|
| 21 | </div>
|
---|
| 22 | </div>
|
---|
| 23 | <!-- End of Header -->
|
---|
| 24 |
|
---|
| 25 | <div id="content">
|
---|
| 26 |
|
---|
| 27 | <h2>Settings Dialog</h2>
|
---|
| 28 |
|
---|
| 29 | <p>The Settings Dialog is displayed using the Tools | Settings menu item and allows the user to
|
---|
| 30 | control some aspects of NUnits operation. Beginning with NUnit 2.4.4, a tree-based dialog
|
---|
| 31 | replaced the older tabbed format.</p>
|
---|
| 32 |
|
---|
| 33 | <hr><h3>Gui Settings - General</h3><hr>
|
---|
| 34 |
|
---|
| 35 | <div class="screenshot-right">
|
---|
| 36 | <img src="img/generalSettings.jpg"></div>
|
---|
| 37 |
|
---|
| 38 | <h3>Gui Display</h3>
|
---|
| 39 |
|
---|
| 40 | <h4>Full Gui</h4>
|
---|
| 41 | <p>Displays the complete gui - as in prior versions of NUnit. This includes the
|
---|
| 42 | test result tabs and the progress bar.</p>
|
---|
| 43 |
|
---|
| 44 | <h4>Mini Gui</h4>
|
---|
| 45 | <p>Switches the display to the mini-gui, which consists of the tree display
|
---|
| 46 | only.</p>
|
---|
| 47 | <h3>Recent Files</h3>
|
---|
| 48 |
|
---|
| 49 | <p>The <b>Display ... files in list</b> TextBox allows the user to choose the number
|
---|
| 50 | of entries to display in the recent files list.
|
---|
| 51 |
|
---|
| 52 | <p>Normally, NUnit checks that project files still exist before
|
---|
| 53 | displaying them in the recent files list. This can cause long delays if the
|
---|
| 54 | file is on a network connection that is no longer available. Unchecking
|
---|
| 55 | <b>Check that files exist before listing</b> will avoid this delay, so
|
---|
| 56 | long as the missing file is not actually selected.
|
---|
| 57 |
|
---|
| 58 | <p>If <b>Load most recent project at startup</b> is checked, the GUI will load the
|
---|
| 59 | last file opened unless it is run with a specific filename or with the
|
---|
| 60 | <code>/noload</code> parameter.</p>
|
---|
| 61 |
|
---|
| 62 | <hr style="clear: both"><h3>Gui Settings - Tree Display</h3><hr>
|
---|
| 63 |
|
---|
| 64 | <div class="screenshot-right">
|
---|
| 65 | <img src="img/treeDisplaySettings.jpg"></div>
|
---|
| 66 |
|
---|
| 67 | <h3>Tree View</h3>
|
---|
| 68 |
|
---|
| 69 | <p>The list box allows selecting the degree of expansion of the tree when tests are loaded:</p>
|
---|
| 70 | <blockquote>
|
---|
| 71 | <p><b>Auto</b> selects a setting based on the space available for the tree display.</p>
|
---|
| 72 | <p><b>Expand</b> expands all tests</p>
|
---|
| 73 | <p><b>Collapse</b> collapses all tests</p>
|
---|
| 74 | <p><b>Hide Tests</b> expands all suites except for the fixtures themselves.</p>
|
---|
| 75 | </blockquote>
|
---|
| 76 |
|
---|
| 77 | <p>If <b>Clear results when reloading</b> is checked, an automatic or manual reload will reinitialize all
|
---|
| 78 | test nodes in the tree (grey display) if it is not checked, result information for tests that do
|
---|
| 79 | not seem to have changed will be retained.</p>
|
---|
| 80 |
|
---|
| 81 | <p>If <b>Save visual state of each project</b> is checked, NUnit saves the state of the tree
|
---|
| 82 | and restores it when the project is next opened. The information saved includes which
|
---|
| 83 | branches of the tree are expanded, the selected node, any checked nodes and any
|
---|
| 84 | category selection.
|
---|
| 85 |
|
---|
| 86 | <p>If <b>Show Checkboxes</b> is checked, the tree includes checkboxes, which may
|
---|
| 87 | be used to select multiple tests for running. This setting is also available
|
---|
| 88 | in the <b>View | Tree</b> menu.</p>
|
---|
| 89 |
|
---|
| 90 | <h3>Test Structure</h3>
|
---|
| 91 |
|
---|
| 92 | <p>If <b>Automatic Namespace suites</b> is selected, tests will be
|
---|
| 93 | shown in a hierarchical listing based on namespaces. This is the
|
---|
| 94 | standard display as used in versions prior to NUnit 2.4.
|
---|
| 95 |
|
---|
| 96 | <p>If <b>Flat list of TestFixtures</b> is selected, tests will be
|
---|
| 97 | shown as a sequential list of fixtures.
|
---|
| 98 |
|
---|
| 99 | <hr style="clear: both"><h3>Gui Settings - Test Results</h3><hr>
|
---|
| 100 |
|
---|
| 101 | <div class="screenshot-right">
|
---|
| 102 | <img src="img/testResultSettings.jpg"></div>
|
---|
| 103 |
|
---|
| 104 | <h3>Errors Tab</h3>
|
---|
| 105 |
|
---|
| 106 | <p>Check <b>Display Errors and Failures Tab</b> to display the
|
---|
| 107 | <b>Errors and Failures</b> tab, which shows information about failing tests.
|
---|
| 108 |
|
---|
| 109 | <p>Check <b>Enable Failure ToolTips</b> to display the tip window over the
|
---|
| 110 | Errors and Failures display and the stack trace. Clear it if you prefer not
|
---|
| 111 | to see the tip window.</p>
|
---|
| 112 |
|
---|
| 113 | <p>Check <b>Enable Word Wrap</b> to turn on word wrapping
|
---|
| 114 | in the Errors and Failures display. While you can select this item and the
|
---|
| 115 | preceding one at the same time, they do not interact well, so you will
|
---|
| 116 | normally choose one or the other.</p>
|
---|
| 117 |
|
---|
| 118 | <h3>Not Run Tab</h3>
|
---|
| 119 |
|
---|
| 120 | <p>Check <b>Display Tests Not Run Tab</b> to display the
|
---|
| 121 | <b>Tests Not Run</b> tab, which shows information about tests that were
|
---|
| 122 | skipped or ignored.
|
---|
| 123 |
|
---|
| 124 | <hr style="clear: both"><h3>Gui Settings - Text Output</h3><hr>
|
---|
| 125 |
|
---|
| 126 | <div class="screenshot-right">
|
---|
| 127 | <img src="img/textOutputSettings.jpg"></div>
|
---|
| 128 |
|
---|
| 129 | <h3>Select Tab</h3>
|
---|
| 130 |
|
---|
| 131 | <p>The <b>Select Tab</b> dropdown list is used to select one of the output tabs, for which
|
---|
| 132 | settings are to be viewed or changed. It also contains entries that allow
|
---|
| 133 | you to add a new tab or edit the list of tabs.
|
---|
| 134 |
|
---|
| 135 | <p>The <b>Restore Defaults</b> button is used to restore the default
|
---|
| 136 | setting, which is a single tab labeled "Text Output." The default tab
|
---|
| 137 | displays all types of output and includes a label for each test that
|
---|
| 138 | displays text.
|
---|
| 139 |
|
---|
| 140 | <p>The <b>Title</b> text box is used to modify the title displayed
|
---|
| 141 | for the selected output tab.
|
---|
| 142 |
|
---|
| 143 | <p><b>Enabled</b> is checked by default. If you uncheck it,
|
---|
| 144 | the selected tab will be removed from the tab control. This allows you to temporarily
|
---|
| 145 | suppress output to a tab without actually removing its definition.
|
---|
| 146 |
|
---|
| 147 | <h3>Content</h3>
|
---|
| 148 |
|
---|
| 149 | <p>The four check boxes enable or disable a particular type of output
|
---|
| 150 | on the selected output window. For each type, the display captures
|
---|
| 151 | output produced while your test is running - either by the test
|
---|
| 152 | itself or by the program you are testing.
|
---|
| 153 |
|
---|
| 154 | <h4>Standard Output</h4>
|
---|
| 155 | <p>Captures all output written to Console.Out.
|
---|
| 156 |
|
---|
| 157 | <h4>Error Output</h4>
|
---|
| 158 | <p>Captures all output written to Console.Error.
|
---|
| 159 |
|
---|
| 160 | <h4>Trace Output</h4>
|
---|
| 161 | <p>Captures all output written to Trace or Debug.
|
---|
| 162 |
|
---|
| 163 | <h4>Log Output</h4>
|
---|
| 164 | <p>Captures output written to a log4net log. NUnit captures
|
---|
| 165 | all output at the Error level or above unless another level
|
---|
| 166 | is specified for the DefaultLogThreshold setting in the
|
---|
| 167 | configuration file for the test assembly or project.
|
---|
| 168 |
|
---|
| 169 | <h3>Test Labels</h3>
|
---|
| 170 |
|
---|
| 171 | <p>Check <b>Display TestCase Labels</b> to precede text in the output window
|
---|
| 172 | with the name of the test that produced it.</p>
|
---|
| 173 |
|
---|
| 174 | <p>Check <b>Suppress label if no output is displayed</b> to eliminate display
|
---|
| 175 | of labels for tests that produce no output in the window.
|
---|
| 176 |
|
---|
| 177 |
|
---|
| 178 | <hr style="clear: both"><h3>Test Loader Settings - Assembly Isolation</h3><hr>
|
---|
| 179 |
|
---|
| 180 | <div class="screenshot-right">
|
---|
| 181 | <img src="img/testLoadSettings.jpg"></div>
|
---|
| 182 |
|
---|
| 183 | <h3>Default Process Model</h3>
|
---|
| 184 |
|
---|
| 185 | <p>These settings determine NUnit's default use of operating system
|
---|
| 186 | processes and may be overridden by settings in the NUnit project.
|
---|
| 187 |
|
---|
| 188 | <p>If <b>Run tests directly in the NUnit process</b> is selected,
|
---|
| 189 | all tests are run in a test domain in the same process as NUnit.
|
---|
| 190 | This is the way previous versions of NUnit ran tests and is the
|
---|
| 191 | default setting.
|
---|
| 192 |
|
---|
| 193 | <p>If <b>Run tests in a single separate process</b> is selected,
|
---|
| 194 | a separate process is used for all tests.
|
---|
| 195 |
|
---|
| 196 | <p>If <b>Run tests in a separate process per Assembly </b> is selected,
|
---|
| 197 | a separate process is used for each test assembly.
|
---|
| 198 |
|
---|
| 199 | <h3>Default Domain Usage</h3>
|
---|
| 200 |
|
---|
| 201 | <p>If <b>Use a separate AppDomain per Assembly</b> is selected, each assembly
|
---|
| 202 | in a multiple-assembly test run will be loaded in a separate AppDomain.
|
---|
| 203 | This setting is not available when <b>Run tests in a separate process
|
---|
| 204 | per Assembly</b> is selected above.
|
---|
| 205 |
|
---|
| 206 | <p>If <b>Use a single AppDomain for all tests</b> is selected, all assemblies in
|
---|
| 207 | a multiple-assembly test run will use the same AppDomain. This was
|
---|
| 208 | the standard behavior of NUnit prior to version 2.4 and is the
|
---|
| 209 | default setting.
|
---|
| 210 |
|
---|
| 211 | <p>If <b>Merge tests across assemblies</b> is checked, the display of tests
|
---|
| 212 | will not be divided across assemblies. If automatic namespace suites are
|
---|
| 213 | used, they will be merged across all assemblies. This option is only
|
---|
| 214 | available when tests are run in the same appdomain.
|
---|
| 215 |
|
---|
| 216 | <hr style="clear: both"><h3>Test Loader Settings - Assembly Reload</h3><hr>
|
---|
| 217 |
|
---|
| 218 | <div class="screenshot-right">
|
---|
| 219 | <img src="img/assemblyReloadSettings.jpg"></div>
|
---|
| 220 |
|
---|
| 221 | <h3>Assembly Reload</h3>
|
---|
| 222 |
|
---|
| 223 | <p>If <b>Reload before each test run</b> is checked, a reload will occur whenever the run button is
|
---|
| 224 | pressed whether the assemblies appear to have changed or not.</p>
|
---|
| 225 |
|
---|
| 226 | <p>If <b>Reload when test assembly changes</b> is checked, assemblies are watched for any change and
|
---|
| 227 | an automatic reload is initiated. This item is disabled on Windows 98 or ME.</p>
|
---|
| 228 |
|
---|
| 229 | <p>If <b>Re-run last tests run</b> is checked, tests are re-run whenever a Reload
|
---|
| 230 | takes place.</p>
|
---|
| 231 |
|
---|
| 232 | <hr style="clear: both"><h3>Test Loader Settings - Advanced</h3><hr>
|
---|
| 233 |
|
---|
| 234 | <div class="screenshot-right">
|
---|
| 235 | <img src="img/advancedSettings.jpg"></div>
|
---|
| 236 |
|
---|
| 237 | <h3>Shadow Copy</h3>
|
---|
| 238 |
|
---|
| 239 | <p>NUnit normally uses .Net shadow-copying in order to allow you to edit
|
---|
| 240 | and recompile assemblies while it is running. Uncheck this box to disable
|
---|
| 241 | shadow-copy only if you have a particular problem that requires it.</p>
|
---|
| 242 |
|
---|
| 243 | <p><b>Note:</b> If you are tempted to disable shadow copy in order to access
|
---|
| 244 | files in the same directory as your assembly, you should be aware that there
|
---|
| 245 | are alternatives. Consider using the Assembly.Codebase property rather than
|
---|
| 246 | Assembly.Location.
|
---|
| 247 |
|
---|
| 248 |
|
---|
| 249 | <hr style="clear: both"><h3>IDE Support Settings - Visual Studio</h3><hr>
|
---|
| 250 |
|
---|
| 251 | <div class="screenshot-right">
|
---|
| 252 | <img src="img/visualStudioSettings.jpg"></div>
|
---|
| 253 |
|
---|
| 254 | <h3>Visual Studio</h3>
|
---|
| 255 |
|
---|
| 256 | <p>If <b>Enable Visual Studio Support</b> is checked, the user will be able to open Visual Studio projects
|
---|
| 257 | and solutions and add Visual Studio projects to existing test projects.</p>
|
---|
| 258 |
|
---|
| 259 | <hr style="clear: both"><h3>Advanced Settings - Internal Trace</h3><hr>
|
---|
| 260 |
|
---|
| 261 | <div class="screenshot-right">
|
---|
| 262 | <img src="img/internalTraceSettings.jpg"></div>
|
---|
| 263 |
|
---|
| 264 | <h3>Internal Trace</h3>
|
---|
| 265 |
|
---|
| 266 | <p>The <b>Trace Level</b> dropdown controls the level of internal trace output.</p>
|
---|
| 267 |
|
---|
| 268 |
|
---|
| 269 |
|
---|
| 270 |
|
---|
| 271 | </div>
|
---|
| 272 |
|
---|
| 273 | <!-- Submenu -->
|
---|
| 274 | <div id="subnav">
|
---|
| 275 | <ul>
|
---|
| 276 | <li><a href="index.html">NUnit 2.5.10</a></li>
|
---|
| 277 | <ul>
|
---|
| 278 | <li><a href="getStarted.html">Getting Started</a></li>
|
---|
| 279 | <li><a href="assertions.html">Assertions</a></li>
|
---|
| 280 | <li><a href="constraintModel.html">Constraints</a></li>
|
---|
| 281 | <li><a href="attributes.html">Attributes</a></li>
|
---|
| 282 | <li><a href="runningTests.html">Running Tests</a></li>
|
---|
| 283 | <ul>
|
---|
| 284 | <li><a href="nunit-console.html">Console Runner</a></li>
|
---|
| 285 | <li><a href="nunit-gui.html">Gui Runner</a></li>
|
---|
| 286 | <ul>
|
---|
| 287 | <li><a href="guiCommandLine.html">Command-Line</a></li>
|
---|
| 288 | <li><a href="mainMenu.html">Main Menu</a></li>
|
---|
| 289 | <li><a href="contextMenu.html">Context Menu</a></li>
|
---|
| 290 | <li id="current"><a href="settingsDialog.html">Settings Dialog</a></li>
|
---|
| 291 | <li><a href="addinsDialog.html">Addins Dialog</a></li>
|
---|
| 292 | <li><a href="testProperties.html">Test Properties</a></li>
|
---|
| 293 | <li><a href="configEditor.html">Configuration Editor</a></li>
|
---|
| 294 | <li><a href="projectEditor.html">Project Editor</a></li>
|
---|
| 295 | </ul>
|
---|
| 296 | <li><a href="pnunit.html">PNUnit Runner</a></li>
|
---|
| 297 | <li><a href="nunit-agent.html">NUnit Agent</a></li>
|
---|
| 298 | <li><a href="runtimeSelection.html">Runtime Selection</a></li>
|
---|
| 299 | <li><a href="assemblyIsolation.html">Assembly Isolation</a></li>
|
---|
| 300 | <li><a href="configFiles.html">Configuration Files</a></li>
|
---|
| 301 | <li><a href="multiAssembly.html">Multiple Assemblies</a></li>
|
---|
| 302 | <li><a href="vsSupport.html">Visual Studio Support</a></li>
|
---|
| 303 | </ul>
|
---|
| 304 | <li><a href="extensibility.html">Extensibility</a></li>
|
---|
| 305 | <li><a href="releaseNotes.html">Release Notes</a></li>
|
---|
| 306 | <li><a href="samples.html">Samples</a></li>
|
---|
| 307 | <li><a href="license.html">License</a></li>
|
---|
| 308 | </ul>
|
---|
| 309 | </ul>
|
---|
| 310 | </div>
|
---|
| 311 | <!-- End of Submenu -->
|
---|
| 312 |
|
---|
| 313 |
|
---|
| 314 | <!-- Standard Footer for NUnit.org -->
|
---|
| 315 | <div id="footer">
|
---|
| 316 | Copyright © 2010 Charlie Poole. All Rights Reserved.
|
---|
| 317 | </div>
|
---|
| 318 | <!-- End of Footer -->
|
---|
| 319 |
|
---|
| 320 | </body>
|
---|
| 321 | </html>
|
---|