{"id":2009,"date":"2019-03-25T17:37:38","date_gmt":"2019-03-25T20:37:38","guid":{"rendered":"http:\/\/xexeu.elipse.com.br\/pt\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/"},"modified":"2019-10-03T13:15:13","modified_gmt":"2019-10-03T16:15:13","slug":"creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver","status":"publish","type":"post","link":"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/","title":{"rendered":"Creating .NET assemblies and instancing them by using the VBScript Driver"},"content":{"rendered":"

1) Introduction<\/span><\/p>\n

From version 1.0 on, the VBScript Driver has had a global method named CreateDotNetObject<\/span>, which enables you to instance data configured on a .NET assembly.<\/p>\n

First, this article will show you how to create and set a Class Library (DLL) by using Microsoft Visual C# 2008. After that, you can check an example instancing this class on E3 and calling its methods via scripts written in the Driver.<\/p>\n

Important<\/span>: You must install .NET Framework Redistributable Package to execute the scripts. To use VBScript Driver’s CreateDotNetObject <\/span>method, you also need .NET Framework 2.0 or higher.<\/p>\n

2) Creating .NET assemblies on Microsoft Visual C# 2008<\/span><\/p>\n

In the Microsoft Visual C# 2008, access the File<\/span>\u2014<\/span>New<\/span>\u2014<\/span>Project<\/span> <\/span>menu. In this example, we will create a Class Library project. Write the project’s name, select the directory and click the OK <\/span>button (Figure 1).<\/p>\n

\"\"<\/div>\n
Figure 1. Creating a new Class Library project<\/span>
\n<\/span><\/div>\n

To configure the .NET assembly to be compatible to the VBScript Driver, you must enable its COM visibility. To do so, just open the project’s properties, click the Assembly Information<\/span> button and check the Make assembly COM-Visible<\/span> option (Figure 2).<\/p>\n

\"\"<\/div>\n
Figure 2. Assembly’s properties<\/span>
\n<\/span><\/div>\n

The project automatically generates a Class1.cs file with a class named Class1 already created in the TestAssembly namespace. In this example, we will create a method to open a message box when it is called.<\/p>\n

You must use the MessageBox.Show<\/span> method to display the message box, so, you need to add a Windows Forms’ reference to the project. In the Project <\/span>menu, click the Add Reference<\/span> item, select the System.Windows.Forms component and click the OK <\/span>button.<\/p>\n

Then, you must add a new method to the class called ShowMessage <\/span>(with no parameter or return) to create a message box with the text “Hello World!”<\/span>.<\/p>\n

namespace TestAssembly<\/span>
{<\/span>
\u00a0 public class Class1<\/span>
\u00a0 {<\/span>
\u00a0\u00a0\u00a0 public void ShowMessage()<\/span>
\u00a0\u00a0\u00a0 {<\/span>
\u00a0\u00a0\u00a0\u00a0\u00a0 System.Windows.Forms.MessageBox.Show(“Hello World!”);<\/span>
\u00a0\u00a0\u00a0 }<\/span>
\u00a0 }<\/span>
}<\/span><\/p>\n

3) Instancing the object and calling methods via Driver’s scripts <\/span><\/p>\n

After compiling the DLL file, you can instance a Class1 object via scripts. So, add the VBScript Driver to the E3 project and access its properties. On the VBScript <\/span>tab, write the script to create a Class1 instance and call the ShowMessage <\/span>method when starting the Driver.<\/p>\n

\"\"<\/div>\n
Figure 3. VBScript Driver’s settings<\/span>
\n<\/span><\/div>\n

Dim obj<\/span>
Sub OnStart()<\/span>
\u00a0 Set obj = CreateDotNetObject(“C:\\TestAssembly.dll”, “TestAssembly.Class1”)<\/span>
\u00a0 obj.ShowMessage()<\/span>
End Sub<\/span>
Sub OnStop()<\/span>
\u00a0 Set obj = Nothing<\/span>
End Sub<\/span>
After adding the script to the corresponding area, click the OK <\/span>button. In the Driver’s design window, click the Activate\/deactivate communication<\/span> button. If all settings are correctly performed, the message box is displayed when activating the Driver (Figure 4).<\/p>\n

\"\"<\/div>\n
Figure 4. Message box displayed by the ShowMessage method<\/span>
\n<\/span><\/div>\n

In the CreateDotNetObject <\/span>method, the first parameter corresponds to the file’s name and path containing the assembly that sets the data type (in this case, it is the TestAssembly.dll file). The second parameter corresponds to the data type’s name, including the namespace (in this example, the Class1 class, which is part of the TestAssembly namespace).<\/p>\n

After creating the object by the function’s return, you can call the ShowMessage <\/span>method. Check the Driver’s documentation for more information about its operation and available functions.<\/p>\n


4) Conclusion<\/span><\/p>\n

In this article, we have presented a simple demonstration on how a class implemented in C# (using the .NET Framework) can be instanced on E3 via VBScript Driver.<\/p>\n

However, this feature enables the user to develop very complex classes by using the Framework’s resources, and it is applicable, especially, to cases where you cannot perform a certain task directly on E3.<\/p>\n

 <\/p>\n

Attachments:<\/h3>\n

Projeto1.zip<\/a>
\nTestAssembly.zip<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

1) Introduction From version 1.0 on, the VBScript Driver has had a global method named CreateDotNetObject, which enables you to instance data configured on a .NET assembly. First, this article…<\/p>\n","protected":false},"author":29,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0},"categories":[800],"tags":[],"yoast_head":"\nCreating .NET assemblies and instancing them by using the VBScript Driver - Elipse Knowledgebase<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Creating .NET assemblies and instancing them by using the VBScript Driver\" \/>\n<meta property=\"og:description\" content=\"1) Introduction From version 1.0 on, the VBScript Driver has had a global method named CreateDotNetObject, which enables you to instance data configured on a .NET assembly. First, this article…\" \/>\n<meta property=\"og:url\" content=\"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/\" \/>\n<meta property=\"og:site_name\" content=\"Elipse Knowledgebase\" \/>\n<meta property=\"article:publisher\" content=\"http:\/\/www.facebook.com\/elipsesoftware\" \/>\n<meta property=\"article:published_time\" content=\"2019-03-25T20:37:38+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2019-10-03T16:15:13+00:00\" \/>\n<meta property=\"og:image\" content=\"http:\/\/kb.elipse.com.br\/pt-br\/images\/ID3010\/Figura01.png\" \/>\n<meta name=\"author\" content=\"M\u00e1rcio Zani Beatrici\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"M\u00e1rcio Zani Beatrici\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/\"},\"author\":{\"name\":\"M\u00e1rcio Zani Beatrici\",\"@id\":\"https:\/\/kb.elipse.com.br\/#\/schema\/person\/af5f797015baba4ffad56036ffe12159\"},\"headline\":\"Creating .NET assemblies and instancing them by using the VBScript Driver\",\"datePublished\":\"2019-03-25T20:37:38+00:00\",\"dateModified\":\"2019-10-03T16:15:13+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/\"},\"wordCount\":594,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/kb.elipse.com.br\/#organization\"},\"articleSection\":[\"Elipse VBScript\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/\",\"url\":\"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/\",\"name\":\"[:pt]Creating .NET assemblies and instancing them by using the VBScript Driver[:] - Elipse Knowledgebase\",\"isPartOf\":{\"@id\":\"https:\/\/kb.elipse.com.br\/#website\"},\"datePublished\":\"2019-03-25T20:37:38+00:00\",\"dateModified\":\"2019-10-03T16:15:13+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"In\u00edcio\",\"item\":\"https:\/\/kb.elipse.com.br\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Creating .NET assemblies and instancing them by using the VBScript Driver\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/kb.elipse.com.br\/#website\",\"url\":\"https:\/\/kb.elipse.com.br\/\",\"name\":\"Elipse Knowledgebase\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/kb.elipse.com.br\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/kb.elipse.com.br\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/kb.elipse.com.br\/#organization\",\"name\":\"Elipse Software\",\"url\":\"https:\/\/kb.elipse.com.br\/\",\"sameAs\":[\"http:\/\/www.facebook.com\/elipsesoftware\"],\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/kb.elipse.com.br\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/kb.elipse.com.br\/wp-content\/uploads\/2019\/05\/schererelipse-com-br\/logoElipse.png\",\"contentUrl\":\"https:\/\/kb.elipse.com.br\/wp-content\/uploads\/2019\/05\/schererelipse-com-br\/logoElipse.png\",\"width\":161,\"height\":58,\"caption\":\"Elipse Software\"},\"image\":{\"@id\":\"https:\/\/kb.elipse.com.br\/#\/schema\/logo\/image\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\/\/kb.elipse.com.br\/#\/schema\/person\/af5f797015baba4ffad56036ffe12159\",\"name\":\"M\u00e1rcio Zani Beatrici\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/kb.elipse.com.br\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/461296b6cd466a0c3d5f83c975c2be68?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/461296b6cd466a0c3d5f83c975c2be68?s=96&d=mm&r=g\",\"caption\":\"M\u00e1rcio Zani Beatrici\"},\"url\":\"https:\/\/kb.elipse.com.br\/en\/author\/zani\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Creating .NET assemblies and instancing them by using the VBScript Driver - Elipse Knowledgebase","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/","og_locale":"en_US","og_type":"article","og_title":"[:pt]Creating .NET assemblies and instancing them by using the VBScript Driver[:] - Elipse Knowledgebase","og_description":"1) Introduction From version 1.0 on, the VBScript Driver has had a global method named CreateDotNetObject, which enables you to instance data configured on a .NET assembly. First, this article…","og_url":"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/","og_site_name":"Elipse Knowledgebase","article_publisher":"http:\/\/www.facebook.com\/elipsesoftware","article_published_time":"2019-03-25T20:37:38+00:00","article_modified_time":"2019-10-03T16:15:13+00:00","og_image":[{"url":"http:\/\/kb.elipse.com.br\/pt-br\/images\/ID3010\/Figura01.png"}],"author":"M\u00e1rcio Zani Beatrici","twitter_card":"summary_large_image","twitter_misc":{"Written by":"M\u00e1rcio Zani Beatrici","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/#article","isPartOf":{"@id":"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/"},"author":{"name":"M\u00e1rcio Zani Beatrici","@id":"https:\/\/kb.elipse.com.br\/#\/schema\/person\/af5f797015baba4ffad56036ffe12159"},"headline":"Creating .NET assemblies and instancing them by using the VBScript Driver","datePublished":"2019-03-25T20:37:38+00:00","dateModified":"2019-10-03T16:15:13+00:00","mainEntityOfPage":{"@id":"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/"},"wordCount":594,"commentCount":0,"publisher":{"@id":"https:\/\/kb.elipse.com.br\/#organization"},"articleSection":["Elipse VBScript"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/","url":"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/","name":"[:pt]Creating .NET assemblies and instancing them by using the VBScript Driver[:] - Elipse Knowledgebase","isPartOf":{"@id":"https:\/\/kb.elipse.com.br\/#website"},"datePublished":"2019-03-25T20:37:38+00:00","dateModified":"2019-10-03T16:15:13+00:00","breadcrumb":{"@id":"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/kb.elipse.com.br\/en\/creating-net-assemblies-and-instancing-them-by-using-the-vbscript-driver\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"In\u00edcio","item":"https:\/\/kb.elipse.com.br\/en\/"},{"@type":"ListItem","position":2,"name":"Creating .NET assemblies and instancing them by using the VBScript Driver"}]},{"@type":"WebSite","@id":"https:\/\/kb.elipse.com.br\/#website","url":"https:\/\/kb.elipse.com.br\/","name":"Elipse Knowledgebase","description":"","publisher":{"@id":"https:\/\/kb.elipse.com.br\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/kb.elipse.com.br\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/kb.elipse.com.br\/#organization","name":"Elipse Software","url":"https:\/\/kb.elipse.com.br\/","sameAs":["http:\/\/www.facebook.com\/elipsesoftware"],"logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/kb.elipse.com.br\/#\/schema\/logo\/image\/","url":"https:\/\/kb.elipse.com.br\/wp-content\/uploads\/2019\/05\/schererelipse-com-br\/logoElipse.png","contentUrl":"https:\/\/kb.elipse.com.br\/wp-content\/uploads\/2019\/05\/schererelipse-com-br\/logoElipse.png","width":161,"height":58,"caption":"Elipse Software"},"image":{"@id":"https:\/\/kb.elipse.com.br\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/kb.elipse.com.br\/#\/schema\/person\/af5f797015baba4ffad56036ffe12159","name":"M\u00e1rcio Zani Beatrici","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/kb.elipse.com.br\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/461296b6cd466a0c3d5f83c975c2be68?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/461296b6cd466a0c3d5f83c975c2be68?s=96&d=mm&r=g","caption":"M\u00e1rcio Zani Beatrici"},"url":"https:\/\/kb.elipse.com.br\/en\/author\/zani\/"}]}},"_links":{"self":[{"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/posts\/2009"}],"collection":[{"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/users\/29"}],"replies":[{"embeddable":true,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/comments?post=2009"}],"version-history":[{"count":3,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/posts\/2009\/revisions"}],"predecessor-version":[{"id":8964,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/posts\/2009\/revisions\/8964"}],"wp:attachment":[{"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/media?parent=2009"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/categories?post=2009"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kb.elipse.com.br\/en\/wp-json\/wp\/v2\/tags?post=2009"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}