DotNetFactory Object

Description

Enables you to create an instance of a .NET object, and access its methods and properties.

IMPORTANT

You can use this object to access the static methods and properties of a class that does not have an instance constructor, for example, System.Environment, as well as a class that does.

Methods

Method CreateInstanceReturns a COM interface for a .NET object.

Back to top

CreateInstance Method

Description

Returns a COM interface for a .NET object.

Syntax

Set var_CreateInstance = DotNetFactory.CreateInstance (TypeName, [Assembly], [args])

Argument

Type

Description

TypeName

String

The full name of the object type, for example, System.Windows.Forms.Form.

Assembly

Any

Optional. If the assembly is preloaded in the registry, you do not need to enter it. Otherwise, you should enter the full path name, for example, System.Windows.Forms. If you want to create an instance of a type in the GAC (Global Assembly Cache), you can enter the short name, for example, Forms.

Note:

  • If you do not pass this argument, OpenText Functional Testing assumes that the assembly is resident in memory. If OpenText Functional Testing does not find the assembly, an error message is displayed during the run session.

  • Some assemblies are designed to depend on specific configuration information. To load such an assembly using DOTNetFactory.CreateInstance, you must add the configuration required by the assembly to the <OpenText Functional Testing installation>/bin/uft.exe.config file before opening.

args

Any

Optional. The required arguments, if any, for the specified TypeName and/or Assembly.

Return Value

A Variant value. Returns the defined instance of the .NET object.

IMPORTANT

If you want to use a .NET object as an argument for a method in OpenText Functional Testing, you must first create a COM interface for the .NET object using the CreateInstance method. Then you pass that interface as the method argument.

The following example uses the CreateInstance method to create an instance of a blank Windows form object, display the form on screen, and then close it after two seconds.

Set var_CreateInstance = DotNetFactory.CreateInstance("System.Windows.Forms.Form", "System.Windows.Forms")
var_CreateInstance.Show
wait 2
var_CreateInstance.Close

The following example uses the CreateInstance method to create an instance of a system environment object, and to display a message box listing the current directory. In this example, there is no need to specify the optional arguments because the required assembly is already in memory.

Set var_CreateInstance = DotNetFactory.CreateInstance("System.Environment")

msgbox var_CreateInstance.CurrentDirectory

Back to top

See also: