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);