The Visual Studio Wizard for .NET Wrapper is an extension for Microsoft Visual Studio, which makes the functionality of the EntireX .NET Wrapper available to Microsoft Visual Studio.
This document covers the following topics:
Supported versions of Microsoft Visual Studio and other prerequisites for EntireX components are described centrally. See Windows Prerequisites.
The EntireX .NET Wrapper Wizard Extension for Visual Studio .NET is part of the EntireX installation. After you have installed EntireX, you can find the installer under etc in your EntireX installation path. To install EntireX .NET Wrapper Extension, start EntireX109.vsix and follow the instructions.
Note:
We recommend you close all other Microsoft applications before installing the extension.
Caution:
The installation path must include the bin directory (e.g.
C:\SoftwareAG\EntireX\bin) of the corresponding EntireX installation, otherwise the extension will not work properly!
Once the wizard has been installed, start Microsoft Visual Studio. Start the New Project Wizard of the Visual Studio and choose EntireX .NET Wrapper Application to start the wizard.
First enter the name of a Software AG IDL file in the opening window. You can select whatever you want to generate client or server code. The project name will be set to IDLNameClient or IDLNameServer automatically. You can enter the name of the path of the .NET Wrapper Runtime DLL if it is not located in the default path.
On the page Broker/Service you can change the default settings for Broker and Service.
On the parameters page you can select the options Sanitize and char/string support.
For more information on Broker/Service and parameters, see the EntireX .NET Wrapper documentation.
When all data has been entered, click the button . A new Visual Studio .NET solution will be generated which includes a project with the name IDLNameClient or IDLNameServer. This project contains the Software AG IDL file, the generated .cs file C# file) and references to the System.dll and the EntireX.NetWrapper.Runtime.dll.
The project will generate a class library (DLL), which can be used in any other .NET project C# or VB.NET). For this purpose an additional App.config file is generated which can be used in a project where an .exe file is generated. The App.config file contains information about Broker, Services etc.
Caution:
Any changes to the Software AG IDL file will trigger the EntireX
extension after saving. The .cs file will be re-generated and
all specifications you made during the implementation will be lost.
Uninstalling an extension is now part of the Visual Studio itself.
To uninstall the extension EntireX .NET Wrapper Application
From the Tools menu, choose Extensions and Updates (VS2017) or Manage Extensions (VS2019).
The EntireX .NET Wrapper Wizard Extension for Visual Studio will be removed from your computer.
Note:
The extension must be uninstalled before you uninstall EntireX, otherwise the uninstall of EntireX will fail.