Version 9.5 SP1
 —  EntireX .NET Wrapper  —

Introduction to the .NET Wrapper

This document covers the following topics:


Description

The EntireX .NET Wrapper provides access to RPC servers for .NET client applications and access to .NET servers for any RPC client. The .NET Wrapper generation tools of the Workbench take as input a Software AG IDL file, which describes the interface of the RPC, and generates C# classes that implement the methods and data types of the interface.

The generated classes can be compiled with the C# compiler into a .NET assembly which can then be called from any .NET language.

The .NET Wrapper works as follows:

Top of page

Generic .NET Wrapper Runtime

In order to minimize the amount of code generated for a specific IDL, all service-type functionality required by the client stub or the server DLL is implemented in a generic .NET Wrapper runtime SoftwareAG.EntireX.NETWrapper.Runtime.dll. The generic .NET Wrapper runtime implements service classes, i.e.:

Top of page

.NET Client Applications

For a given IDL file, the Software AG IDL Compiler and a C# code generation template for clients are used to generate a client stub. The source code generated by the .NET Wrapper can be compiled into a .NET assembly with the C# compiler. Application developers can use the generated client stub assembly to write .NET applications that access RPC servers. They are not limited to C# as programming language. Any .NET programming language based on the Common Language Runtime (CLR) can make use of the client stub assembly. Choices are C#, VisualBasic.NET or managed C++.

dot_net client

Top of page

.NET Server DLL

The Software AG IDL Compiler and a C# code generation template for servers are used to generate a C# code frame for a specific IDL. Application developers can use the generated frame to write their own server code for each program in the IDL. The source code can be compiled into a .NET assembly (DLL) with the C# compiler. The assembly name needs to match the library name as specified in the IDL file.

dot_net server

Top of page