property NETObjectTemplate.Template as String
Executes the x-script code.

TypeDescription
String A String expression that specifies the x-script/template code to be executed.
Use the Template/Item property to get/set properties / fields / parameters, invoke methods of the hosting /NET framework Value, using the x-script code. The Item property does exactly the same thing as Template call, excepts that it returns the TemplateResult property. For instance, using the Template/Item property you can change the hosting control's background color, add nodes, and so on. Prior to Template/Item call, you can invoke the SetTemplateDef to define values from your code to Template's code ( TemplateDef variables ).

in VB/NET under the .NET Framework, you use a code like follows to add nodes to a TreeView control:

With TreeView1
    With .Nodes.Add("Root 1")
        .Nodes.Add("Child 1")
        With .Nodes.Add("Child 2")
            .Nodes.Add("Sub-Child 2.1")
            .Nodes.Add("Sub-Child 2.2")
            .Nodes.Add("Sub-Child 2.3")
            .Expand()
        End With
        .Nodes.Add("Child 3")
        .Expand()
    End With
    With .Nodes.Add("Root 2")
        .Nodes.Add("Child 1")
        .Nodes.Add("Child 2")
        .Nodes.Add("Child 3")
    End With
End With

while on VB using the NETHost control you should use a code like:

With NETHost1
    .AssemblyLocation = "C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll"
    .AssemblyName = "System.Windows.Forms.TreeView"
    With .Host
        With .Item("Nodes.Add(`Root 1`)")
            .Template = "Nodes.Add(`Child 1`)"
            With .Item("Nodes.Add(`Child 2`)")
                .Template = "Nodes.Add(`Sub-Child 2.1`)"
                .Template = "Nodes.Add(`Sub-Child 2.2`)"
                .Template = "Nodes.Add(`Sub-Child 2.3`)"
                .Template = "Expand()"
            End With
            .Template = "Nodes.Add(`Child 3`)"
            .Template = "Expand()"
        End With
        With .Item("Nodes.Add(`Root 2`)")
            .Template = "Nodes.Add(`Child 1`)"
            .Template = "Nodes.Add(`Child 2`)"
            .Template = "Nodes.Add(`Child 3`)"
        End With
    End With
End With

The Template/ x-script code is a simple way of calling hosting control/object's properties, methods/ events using strings. Exontrol owns the x-script implementation in its easiest way and it does not require any VB engine to get executed. Our simple rule is using the component alone without any other dependency than the Windows system.

The Template/x-script syntax in BNF notation is defined like follows:

<x-script> := <lines>
<lines> := <line>[<eol> <lines>] | <block>
<block> := <call> [<eol>] { [<eol>] <lines> [<eol>] } [<eol>]
<eol> := ";" | "\r\n"
<line> := <dim> | <createobject> | <call> | <set> | <comment>
<dim> := "DIM" <variables>
<variables> := <variable> [, <variables>]
<variable> := "ME" | <identifier>
<createobject> := "CREATEOBJECT(`"<type>"`)"
<call> := <variable> | <property> | <variable>"."<property> | <createobject>"."<property>
<property> := [<property>"."]<identifier>["("<parameters>")"]
<set> := <call> "=" <value>
<property> := <identifier> | <identifier>"("[<parameters>]")"
<parameters> := <value> [","<parameters>]
<value> := <boolean> | <number> | <color> | <date> | <string> | <createobject> | <call>
<boolean> := "TRUE" | "FALSE"
<number> := "0X"<hexa> | ["-"]<integer>["."<integer>]
<digit10> := 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9
<digit16> := <digit10> | A | B | C | D | E | F
<integer> := <digit10>[<integer>]
<hexa> := <digit16>[<hexa>]
<color> := "RGB("<integer>","<integer>","<integer>")"
<date> := "#"<integer>"/"<integer>"/"<integer>" "[<integer>":"<integer>":"<integer>"]"#"
<string> := '"'<text>'"' | "`"<text>"`"
<comment> := "'"<text>

where:

<identifier> indicates an identifier of the variable, property or method, and should start with a letter.
<type> indicates the type the CreateObject function creates, as the assembly-qualified name of the type to create.
<text> any string of characters

The Template / x-script is composed by lines of instructions. Instructions are separated by "\r\n" ( new line characters ) or ";" character. The TemplateThrowError property specifies whether the control fires an exception/error when the Template call fails. The TemplateError / TemplateException gets the error if the Template calls fails. The TemplateResult property returns the result of the last instruction into a Template call, as a NETObjectTemplate object.

An x-script instruction/line can be one of the following:

where

The x-script uses constant expressions as follows:

Also , the template or x-script code supports general functions as follows:

The following samples shows how you can use the Template and TemplateResult properties:

VBA (MS Access, Excell...)

With NETHost1
	.AssemblyLocation = "C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll"
	.AssemblyName = "System.Windows.Forms.TreeView"
	With .Host
		.Template = "Nodes.Add(`Root 1`)"
		With .TemplateResult
			.Template = "Nodes.Add(`Child 1`)"
			.Template = "Nodes.Add(`Child 2`)"
			.Template = "Expand()"
		End With
	End With
End With

VB6

With NETHost1
	.AssemblyLocation = "C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll"
	.AssemblyName = "System.Windows.Forms.TreeView"
	With .Host
		.Template = "Nodes.Add(`Root 1`)"
		With .TemplateResult
			.Template = "Nodes.Add(`Child 1`)"
			.Template = "Nodes.Add(`Child 2`)"
			.Template = "Expand()"
		End With
	End With
End With

VB.NET

With Exnethost1
	.AssemblyLocation = "C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll"
	.AssemblyName = "System.Windows.Forms.TreeView"
	With .Host
		.Template = "Nodes.Add(`Root 1`)"
		With .TemplateResult
			.Template = "Nodes.Add(`Child 1`)"
			.Template = "Nodes.Add(`Child 2`)"
			.Template = "Expand()"
		End With
	End With
End With

VB.NET for /COM

With AxNETHost1
	.AssemblyLocation = "C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll"
	.AssemblyName = "System.Windows.Forms.TreeView"
	With .Host
		.Template = "Nodes.Add(`Root 1`)"
		With .TemplateResult
			.Template = "Nodes.Add(`Child 1`)"
			.Template = "Nodes.Add(`Child 2`)"
			.Template = "Expand()"
		End With
	End With
End With

C++

/*
	Copy and paste the following directives to your header file as
	it defines the namespace 'exontrol_NETHost' for the library: 'Exontrol NETHost ActiveX Component'

	#import <exontrol.NETHost.tlb>
*/
exontrol_NETHost::INETHostCtrlPtr spNETHost1 = GetDlgItem(IDC_NETHOST1)->GetControlUnknown();
spNETHost1->PutAssemblyLocation(L"C:\\Windows\\assembly\\GAC_MSIL\\System.Windows.Forms\\2.0.0.0__b77a5c561934e089\\System.Windows.Forms.dll");
spNETHost1->PutAssemblyName(L"System.Windows.Forms.TreeView");
exontrol_NETHost::INETObjectTemplatePtr var_NETObjectTemplate = spNETHost1->GetHost();
	var_NETObjectTemplate->PutTemplate(L"Nodes.Add(`Root 1`)");
	exontrol_NETHost::INETObjectTemplatePtr var_NETObjectTemplate1 = var_NETObjectTemplate->GetTemplateResult();
		var_NETObjectTemplate1->PutTemplate(L"Nodes.Add(`Child 1`)");
		var_NETObjectTemplate1->PutTemplate(L"Nodes.Add(`Child 2`)");
		var_NETObjectTemplate1->PutTemplate(L"Expand()");

C++ Builder

NETHost1->AssemblyLocation = L"C:\\Windows\\assembly\\GAC_MSIL\\System.Windows.Forms\\2.0.0.0__b77a5c561934e089\\System.Windows.Forms.dll";
NETHost1->AssemblyName = L"System.Windows.Forms.TreeView";
Exontrol_nethost_tlb::INETObjectTemplatePtr var_NETObjectTemplate = NETHost1->Host;
	var_NETObjectTemplate->Template = L"Nodes.Add(`Root 1`)";
	Exontrol_nethost_tlb::INETObjectTemplatePtr var_NETObjectTemplate1 = var_NETObjectTemplate->TemplateResult;
		var_NETObjectTemplate1->Template = L"Nodes.Add(`Child 1`)";
		var_NETObjectTemplate1->Template = L"Nodes.Add(`Child 2`)";
		var_NETObjectTemplate1->Template = L"Expand()";

C#

exnethost1.AssemblyLocation = "C:\\Windows\\assembly\\GAC_MSIL\\System.Windows.Forms\\2.0.0.0__b77a5c561934e089\\System.Windows.Forms.dll";
exnethost1.AssemblyName = "System.Windows.Forms.TreeView";
exontrol_NETHost.NETObjectTemplate var_NETObjectTemplate = exnethost1.Host;
	var_NETObjectTemplate.Template = "Nodes.Add(`Root 1`)";
	exontrol_NETHost.NETObjectTemplate var_NETObjectTemplate1 = var_NETObjectTemplate.TemplateResult;
		var_NETObjectTemplate1.Template = "Nodes.Add(`Child 1`)";
		var_NETObjectTemplate1.Template = "Nodes.Add(`Child 2`)";
		var_NETObjectTemplate1.Template = "Expand()";

JScript/JavaScript

<BODY onload="Init()">
<OBJECT CLASSID="clsid:FDCBA3E0-4E2F-4DC7-B073-EAA7BD7EC565" id="NETHost1"></OBJECT>

<SCRIPT LANGUAGE="JScript">
function Init()
{
	NETHost1.AssemblyLocation = "C:\\Windows\\assembly\\GAC_MSIL\\System.Windows.Forms\\2.0.0.0__b77a5c561934e089\\System.Windows.Forms.dll";
	NETHost1.AssemblyName = "System.Windows.Forms.TreeView";
	var var_NETObjectTemplate = NETHost1.Host;
		var_NETObjectTemplate.Template = "Nodes.Add(`Root 1`)";
		var var_NETObjectTemplate1 = var_NETObjectTemplate.TemplateResult;
			var_NETObjectTemplate1.Template = "Nodes.Add(`Child 1`)";
			var_NETObjectTemplate1.Template = "Nodes.Add(`Child 2`)";
			var_NETObjectTemplate1.Template = "Expand()";
}
</SCRIPT>
</BODY>

VBScript

<BODY onload="Init()">
<OBJECT CLASSID="clsid:FDCBA3E0-4E2F-4DC7-B073-EAA7BD7EC565" id="NETHost1"></OBJECT>

<SCRIPT LANGUAGE="VBScript">
Function Init()
	With NETHost1
		.AssemblyLocation = "C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll"
		.AssemblyName = "System.Windows.Forms.TreeView"
		With .Host
			.Template = "Nodes.Add(`Root 1`)"
			With .TemplateResult
				.Template = "Nodes.Add(`Child 1`)"
				.Template = "Nodes.Add(`Child 2`)"
				.Template = "Expand()"
			End With
		End With
	End With
End Function
</SCRIPT>
</BODY>

C# for /COM

axNETHost1.AssemblyLocation = "C:\\Windows\\assembly\\GAC_MSIL\\System.Windows.Forms\\2.0.0.0__b77a5c561934e089\\System.Windows.Forms.dll";
axNETHost1.AssemblyName = "System.Windows.Forms.TreeView";
exontrol_NETHost.NETObjectTemplate var_NETObjectTemplate = axNETHost1.Host;
	var_NETObjectTemplate.Template = "Nodes.Add(`Root 1`)";
	exontrol_NETHost.NETObjectTemplate var_NETObjectTemplate1 = var_NETObjectTemplate.TemplateResult;
		var_NETObjectTemplate1.Template = "Nodes.Add(`Child 1`)";
		var_NETObjectTemplate1.Template = "Nodes.Add(`Child 2`)";
		var_NETObjectTemplate1.Template = "Expand()";

X++ (Dynamics Ax 2009)

public void init()
{
	COM com_NETObjectTemplate,com_NETObjectTemplate1;
	anytype var_NETObjectTemplate,var_NETObjectTemplate1;
	;

	super();

	exnethost1.AssemblyLocation("C:\\Windows\\assembly\\GAC_MSIL\\System.Windows.Forms\\2.0.0.0__b77a5c561934e089\\System.Windows.Forms.dll");
	exnethost1.AssemblyName("System.Windows.Forms.TreeView");
	var_NETObjectTemplate = exnethost1.Host(); com_NETObjectTemplate = var_NETObjectTemplate;
		com_NETObjectTemplate.Template("Nodes.Add(`Root 1`)");
		var_NETObjectTemplate1 = com_NETObjectTemplate.TemplateResult(); com_NETObjectTemplate1 = var_NETObjectTemplate1;
			com_NETObjectTemplate1.Template("Nodes.Add(`Child 1`)");
			com_NETObjectTemplate1.Template("Nodes.Add(`Child 2`)");
			com_NETObjectTemplate1.Template("Expand()");
}

Delphi 8 (.NET only)

with AxNETHost1 do
begin
	AssemblyLocation := 'C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll';
	AssemblyName := 'System.Windows.Forms.TreeView';
	with Host do
	begin
		Template := 'Nodes.Add(`Root 1`)';
		with TemplateResult do
		begin
			Template := 'Nodes.Add(`Child 1`)';
			Template := 'Nodes.Add(`Child 2`)';
			Template := 'Expand()';
		end;
	end;
end

Delphi (standard)

with NETHost1 do
begin
	AssemblyLocation := 'C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll';
	AssemblyName := 'System.Windows.Forms.TreeView';
	with Host do
	begin
		Template := 'Nodes.Add(`Root 1`)';
		with TemplateResult do
		begin
			Template := 'Nodes.Add(`Child 1`)';
			Template := 'Nodes.Add(`Child 2`)';
			Template := 'Expand()';
		end;
	end;
end

VFP

with thisform.NETHost1
	.AssemblyLocation = "C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll"
	.AssemblyName = "System.Windows.Forms.TreeView"
	with .Host
		.Template = "Nodes.Add(`Root 1`)"
		with .TemplateResult
			.Template = "Nodes.Add(`Child 1`)"
			.Template = "Nodes.Add(`Child 2`)"
			.Template = "Expand()"
		endwith
	endwith
endwith

dBASE Plus

local oNETHost,var_NETObjectTemplate,var_NETObjectTemplate1

oNETHost = form.Activex1.nativeObject
oNETHost.AssemblyLocation = "C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll"
oNETHost.AssemblyName = "System.Windows.Forms.TreeView"
var_NETObjectTemplate = oNETHost.Host
	var_NETObjectTemplate.Template = "Nodes.Add(`Root 1`)"
	var_NETObjectTemplate1 = var_NETObjectTemplate.TemplateResult
		var_NETObjectTemplate1.Template = "Nodes.Add(`Child 1`)"
		var_NETObjectTemplate1.Template = "Nodes.Add(`Child 2`)"
		var_NETObjectTemplate1.Template = "Expand()"

XBasic (Alpha Five)

Dim oNETHost as P
Dim var_NETObjectTemplate as P
Dim var_NETObjectTemplate1 as P

oNETHost = topparent:CONTROL_ACTIVEX1.activex
oNETHost.AssemblyLocation = "C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll"
oNETHost.AssemblyName = "System.Windows.Forms.TreeView"
var_NETObjectTemplate = oNETHost.Host
	var_NETObjectTemplate.Template = "Nodes.Add(`Root 1`)"
	var_NETObjectTemplate1 = var_NETObjectTemplate.TemplateResult
		var_NETObjectTemplate1.Template = "Nodes.Add(`Child 1`)"
		var_NETObjectTemplate1.Template = "Nodes.Add(`Child 2`)"
		var_NETObjectTemplate1.Template = "Expand()"

Visual Objects

local var_NETObjectTemplate as INETObjectTemplate
local var_NETObjectTemplate1 as INETObjectTemplate

oDCOCX_Exontrol1:AssemblyLocation := "C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll"
oDCOCX_Exontrol1:AssemblyName := "System.Windows.Forms.TreeView"
var_NETObjectTemplate := oDCOCX_Exontrol1:Host
	var_NETObjectTemplate:Template := "Nodes.Add(`Root 1`)"
	var_NETObjectTemplate1 := var_NETObjectTemplate:TemplateResult
		var_NETObjectTemplate1:Template := "Nodes.Add(`Child 1`)"
		var_NETObjectTemplate1:Template := "Nodes.Add(`Child 2`)"
		var_NETObjectTemplate1:Template := "Expand()"

PowerBuilder

OleObject oNETHost,var_NETObjectTemplate,var_NETObjectTemplate1

oNETHost = ole_1.Object
oNETHost.AssemblyLocation = "C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll"
oNETHost.AssemblyName = "System.Windows.Forms.TreeView"
var_NETObjectTemplate = oNETHost.Host
	var_NETObjectTemplate.Template = "Nodes.Add(`Root 1`)"
	var_NETObjectTemplate1 = var_NETObjectTemplate.TemplateResult
		var_NETObjectTemplate1.Template = "Nodes.Add(`Child 1`)"
		var_NETObjectTemplate1.Template = "Nodes.Add(`Child 2`)"
		var_NETObjectTemplate1.Template = "Expand()"

Visual DataFlex

Procedure OnCreate
	Forward Send OnCreate
	Set ComAssemblyLocation to "C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll"
	Set ComAssemblyName to "System.Windows.Forms.TreeView"
	Variant voNETObjectTemplate
	Get ComHost to voNETObjectTemplate
	Handle hoNETObjectTemplate
	Get Create (RefClass(cComNETObjectTemplate)) to hoNETObjectTemplate
	Set pvComObject of hoNETObjectTemplate to voNETObjectTemplate
		Set ComTemplate of hoNETObjectTemplate to "Nodes.Add(`Root 1`)"
		Variant voNETObjectTemplate1
		Get ComTemplateResult of hoNETObjectTemplate to voNETObjectTemplate1
		Handle hoNETObjectTemplate1
		Get Create (RefClass(cComNETObjectTemplate)) to hoNETObjectTemplate1
		Set pvComObject of hoNETObjectTemplate1 to voNETObjectTemplate1
			Set ComTemplate of hoNETObjectTemplate1 to "Nodes.Add(`Child 1`)"
			Set ComTemplate of hoNETObjectTemplate1 to "Nodes.Add(`Child 2`)"
			Set ComTemplate of hoNETObjectTemplate1 to "Expand()"
		Send Destroy to hoNETObjectTemplate1
	Send Destroy to hoNETObjectTemplate
End_Procedure

XBase++

#include "AppEvent.ch"
#include "ActiveX.ch"

PROCEDURE Main
 	LOCAL oForm
	LOCAL nEvent := 0, mp1 := NIL, mp2 := NIL, oXbp := NIL
	LOCAL oNETObjectTemplate
	LOCAL oNETObjectTemplate1
	LOCAL oNETHost

	oForm := XbpDialog():new( AppDesktop() )
	oForm:drawingArea:clipChildren := .T.
	oForm:create( ,,{100,100}, {640,480},, .F. )
	oForm:close  := {|| PostAppEvent( xbeP_Quit )}

	oNETHost := XbpActiveXControl():new( oForm:drawingArea )
	oNETHost:CLSID  := "Exontrol.NETHost" /*{FDCBA3E0-4E2F-4DC7-B073-EAA7BD7EC565}*/
	oNETHost:create(,, {10,60},{610,370} )

		oNETHost:AssemblyLocation := "C:\Windows\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll"
		oNETHost:AssemblyName := "System.Windows.Forms.TreeView"
		oNETObjectTemplate := oNETHost:Host()
			oNETObjectTemplate:Template := "Nodes.Add(`Root 1`)"
			oNETObjectTemplate1 := oNETObjectTemplate:TemplateResult()
				oNETObjectTemplate1:Template := "Nodes.Add(`Child 1`)"
				oNETObjectTemplate1:Template := "Nodes.Add(`Child 2`)"
				oNETObjectTemplate1:Template := "Expand()"

	oForm:Show()
	DO WHILE nEvent != xbeP_Quit
		nEvent := AppEvent( @mp1, @mp2, @oXbp )
		oXbp:handleEvent( nEvent, mp1, mp2 )
	ENDDO 
RETURN