DotNetUnitTestFreeObject Function

Action

Releases the object handle, so that the garbage collector will free the object. The object should be loaded with DotNetUnitTestLoadObject in order to work correctly.

Before the object is freed it is possible that a global CleanUp method will be called. Following unit testing frameworks support a unit-test wide CleanUp method:

Silk Performer .NET Framework
NUnit Test Framework
Microsoft's unit testing framework (Microsoft Visual Studio 2013, 2015, 2017)

During DotNetUnitTestLoadObject the information about such a method is gathered. If such a method exists, it will be called right before the object is freed.

Include file

DotNetAPI.bdh

Syntax

DotNetUnitTestFreeObject( in hObject: number,
                          in sTimer : string optional ): boolean;

Return value

true if successful
false otherwise

Parameter	Description
hObject	Handle to a .NET Object that will be released.
sTimer	(optional) If the Unit Test class defines a global TearDown method an additional measure will be generated for this additional method call. The measure name will be {sTimer}_GlobalTearDown.

Parameter

Description

hObject

Handle to a .NET Object that will be released.

sTimer

(optional)

If the Unit Test class defines a global TearDown method an additional measure will be generated for this additional method call. The measure name will be {sTimer}_GlobalTearDown.

Example

dcltrans
  transaction TMain
  var
    hObject : number;
  begin
    DotNetSetOption(DOTNET_OPT_REDIRECT_CONSOLE, 1);
    hObject := DotNetUnitTestLoadObject("bin\\Release\\MyDotNet.dll", "MyDotNet.TestClass");
    DotNetUnitTestCallMethod(hObject,"TestMethod");
    DotNetUnitTestFreeObject(hObject);
  end TMain;