CREATE Function (Automation)

Creates an Automation object.

[Ok :=] CREATE(Automation [,NewServer] [,OnClient])

Parameters

  • Automation
    Type: Automation A variable that has previously been declared.
  • NewServer
    Type: Boolean If NewServer is false, which is the default value, then the CREATE function tries to reuse an already running instance of the Automation server that is referenced by Automation before creating a new instance. If NewServer is true, then the CREATE function always creates a new instance of the Automation server.
  • OnClient
    Type: Boolean OnClient must evaluate to true. You can either set the parameter to true or define a Boolean type variable that evaluates to true. If variable evaluates to false, then you will see a run-time error.

Property Value/Return Value

Type: Boolean

true if the Automation object could be created; otherwise, false.

If the return value is not tested, then execution will end with a run-time error.

Supported Display Targets

Microsoft Dynamics NAV Windows client only

Remarks

Important

This function is not supported by the Microsoft Dynamics NAV Web client or Microsoft Dynamics NAV Portal Framework for Microsoft SharePoint 2010.

The CREATE function instantiates, or creates, the Automation server that is referenced by the Automation variable. An OCX, or a custom control, is instantiated implicitly, but Automation variables must be created explicitly.

If you have an array of OCXs, then each control is created when its first member is accessed.

If you have an array of Automation servers, then you have to call the CREATE function on each element individually. The NewServer variable can be used independently on each element.

The Automation object that is created can be explicitly destroyed by the CLEAR Function. The object is implicitly destroyed when the Automation variable goes out of scope.

An Automation variable can only be created one time. You will get a run-time error if you try to create an Automation variable again and do not call CLEAR first. You also get a run-time error if you try to create an OCX variable.

Example

The following example shows how you can use the CREATE function. This example requires that you create the following variables.

Name DataType Subtype

Document

Automation

'Microsoft XML, V3.0'.DOMDocument

ReturnValue

Boolean

Not applicable

ReturnValue := CREATE(Document, FALSE, TRUE);

See Also

Reference

Automation Data Type