[TOC] [Prev] [Next] [Bottom]

<@CREATEOBJECT>

Syntax

<@CREATEOBJECT TYPE=type OBJECTID=objectID [EXPIRYURL=url] [INITSTRING=string] [SYSTEMOBJECT=true|false]>

Description

This meta tag creates a new instance of a particular object. It is usually used in conjunction with the <@ASSIGN> meta tag or the Assign action.

The TYPE attribute defines the name of any valid Tango object handler: COM, JavaBean, or TCF (Tango class file).

The OBJECTID attribute defines the object: for COM, the ProgID or ClassID; for Tango class files, the file name; for JavaBeans, the name of the JavaBean.


! Note:


The EXPIRYURL attribute defines a URL to call when the variable expires.

Meta tags are allowed in all attributes. This tag does not return anything.

COM-specific Attributes

The INITSTRING attribute is used for COM only, and defines the object-specific string to use for initialization. The SYSTEMOBJECT attribute is used for COM only, and can have the value TRUE or (the default) FALSE. If true, Tango gets an existing instance from the system rather than creating a new one.

Example

The following meta tags create an object instance variable called myObject in local scope and creates an object instance of the COM object TangoOM.clsTangoOM:

<@ASSIGN NAME=myObject SCOPE=local VALUE=<@CREATEOBJECT TYPE=COM OBJECTID=TangoOM.clsTangoOM>>

See Also

<@CALLMETHOD>
<@GETPARAM>
<@NUMOBJECTS>
<@OBJECTAT>
<@OBJECTS></@OBJECTS>



[TOC] [Prev] [Next] [Bottom]

docs@pervasive.com
Copyright © 1999, Pervasive Software. All rights reserved.