.NET Connector
Use the Verastream .NET Connector to create WS-I compliant Microsoft .NET applications that integrate host data into Web applications or client/server applications. Microsoft .NET is an XML Web services platform that developers can use to create programs that transcend device boundaries and fully harness the connectivity of the Internet.
This reference is intended for developers who are familiar with object-oriented development environments and who have a thorough knowledge of Visual Basic, C#, or ASP.NET Web programming with scripting languages like JScript or VBScript. You should also be familiar with the Host Integrator Design Tool, VHI model files, and the Host Integrator server.
This section describes Verastream's .NET connector and provides you with tips on how to build powerful and robust applications that take advantage of the connector's features and options:
Overloaded Methods
Other Verastream connectors support the use of optional parameters or null arguments to accommodate the different arguments you might or might not want to include. For example, the ConnectToModel method in the COM connector has two required arguments and three optional arguments, as indicated by this syntax:
object.ConnectToModel Server, ModelName, [UserID], [Password], [ModelVariables]
In the .NET connector help, separate versions of a method, called overloads, are presented for likely or common combinations of arguments. For ConnectToMethod, there are four such overloads:
ConnectToModel(server, modelName)
ConnectToModel(server, ModelName, UserID, password)
ConnectToModel(server, ModelName, UserVariables)
ConnectToModel(server, ModelName, UserID, password, ModelVariables)
This style of presentation makes explicit exactly which combinations of arguments are legal. It may seem obvious that the password argument cannot be used without the userID argument, the overloaded syntax statements in the .NET connector make this explicit, while the optional argument syntax used in the COM connector does not.
The namespace for the .NET Connector is WRQ.Verastream.HostIntegrator. A .NET namespace is analogous to a package in Java.
Help Available in Multiple Formats
The classes, methods, and properties that comprise the .NET connector are documented in a MSDN-style compiled help system that is included with Verastream Host Integrator.
Context-sensitive help on the various elements of the .NET connector is also available with Visual Studio.
Requirements
The .NET Connector is an install option, which copies the necessary files to your computer.
To use the .NET connector to develop an application that accesses the host application model file on your Host Integrator Server, you need:
- .NET development tool--Microsoft Visual Studio .NET., version 7.0 or higher.
- .NET Framework SDK, version 2.0 or higher, to link to information on .NET data types from the Verastream MSDN-style compiled help system. The .NET Framework extends Microsoft's .NET implementation, providing improvements to existing features and enhancements to the documentation. You can use the .NET Framework to build, deploy, and run XML Web services and .NET-connected applications.
To create .NET projects that can interact with Host Integrator through the .NET connector, you must add a reference to the connector library in Visual Studio .NET which can be found here:
<VHI install folder>\lib\dotnet\WRQ.Verastream.HostIntegrator.dll
Method Reference
The reference for the Host Integrator .NET connecter is available here.
IMPORTANT NOTE
Depending on how you are accessing this file, it may be necessary for you to save the file to a local machine and open the file from that location. To open the file from the local machine, right-click and choose Properties. On the General tab, click Unblock, and then OK.