Verastream .NET Connector Introduction

Use the Verastream .NET Connector to create Microsoft .NET applications that integrate host data into web applications or client/server applications. Microsoft .NET is an XML Web Services platform that enables developers to create programs that transcend device boundaries and fully harness the connectivity of the Internet. 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.

See any of the following sections for further details:

Overloaded Methods
Help Available in Multiple Formats
Namespace
Audience
.NET Samples

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)

One advantage of this style of presentation is that it makes explicit exactly which combinations of arguments are legal. So while 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.

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. If you have the Microsoft .NET Framework Software Development Kit (version 1.1 or higher) installed on your computer, you can link directly from this compiled Verastream help to the Microsoft help for information on .NET data types.

Context-sensitive help on the various elements of the .NET connector is also available with Visual Studio.

Namespace

The namespace for the .NET Connector is WRQ.Verastream.HostIntegrator. A .NET namespace is analogous to a package in Java.

Audience

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 Verastream Design Tool (and the model files you can create with it), as well as with the Host Integrator Server.

.NET Samples

No .NET sample projects are provided, but with the Web Builder tool you can easily create projects, based on the "demo" models provided with Verastream Host Integrator, that use the .NET connector.