Click here to Skip to main content
15,868,141 members
Articles / Web Development / IIS

.NET Remoting under IIS - ASP.NET Application as Client

Rate me:
Please Sign up or sign in to vote.
4.13/5 (20 votes)
2 Aug 2009CPOL5 min read 178.7K   1.2K   53   36
Simplest method to host remote component under IIS with ASP.NET application as client

Introduction

I have come across couple of good articles that tell us about creating .NET remote application, but none of these use ASP.NET application as client. Even the MSDN example, Hosting in Internet Information Services (IIS), uses a console application as client.

Background

If the remote object is to be accessed through the internet, one should implement their own security to authenticate the user as .NET remote applications require FullTrust permissions to execute. By hosting remote application under IIS, implementing security becomes much easier especially when the intranet is protected from the outside world by a firewall and the allowed communication channel is HTTP.

Using the Code

Here are the steps to create a server application and client application.

Server Object

  1. Create a new VB.NET or C# class library IServer and replace code in Class1.vb with the following. Compile the project to IServer.dll.
    VB.NET
    Public Interface IServer
    
        Function getServerTime() As DateTime
    
    End Interface
  2. Create new VB.NET or C# Class Library project with clsServer class which will implement getServerTime function of interface IServer.
    VB.NET
    Public Class clsServer
        Inherits MarshalByRefObject
        Implements IServer.IServer
    
        Public Overridable Function getServerTime() _
                 As DateTime Implements IServer.IServer.getServerTime
            Return Now.ToString()
        End Function
    End Class
  3. I have also included one more function in the demo project to create a file in the server. This will convince the user beyond any doubt that remote object did get activated through transparent proxy. Please make sure that the folder where you want to create the file has write permissions.
  4. Compile this project into "Server.dll" or any other name that is appropriate.
  5. Create a new virtual directory, Server under IIS - either by using "Virtual Directory Creation Wizard" or
    • Create new folder under c:\Inetpub\wwwroot and rename it to Server.
    • Open IIS management console, view properties of the Server folder.
    • Click on the Create button against the "Application name", by default new application name will be the name of the folder. Click on OK button to close the properties window.
    Image 1Image 2
  6. Navigate to Server folder in Windows Explorer and create a sub folder "bin" under Server folder.
  7. Copy "Server.dll" into the bin folder.
  8. Create new text file, type the following XML code and save it as "web.config" and not as web.config.txt (by selecting "All files" in the Save As dialog box or by enclosing the file name in double quotes in the save dialog box). This XML code declares the service and channel. MSDN has a lot of information about each of these XML attributes that we are coding here.
    XML
    <?xml version="1.0" encoding="utf-8" ?>
    <configuration>
    <system.runtime.remoting>
        <application>
    
            <service>
                <wellknown mode="Singleton" type="Server.clsServer,
                           Server" objectUri="server.soap" />
            </service>
            <channels>
                <channel ref="http" />
                <serverProviders>
                    <formatter href="binary" />
                </serverProviders>
            </channels>
        </application>
    </system.runtime.remoting>
    </configuration>
  9. The most important attribute that we need to understand is "type". In the above example, its value is "Server.clsServer, Server" which is nothing but "RootNamespace.ClassName, Assembly name". To find out what these value are for an existing project, just right click on the project name in solution explorer and choose properties. ObjectUri is something that uniquely identifies this object which is required to invoke this object from client. We can use the other format "Server.rem" .
  10. The channel that we are using is HTTP and formatter is binary. Please refer to MSDN for alternative channels and formatters. We need to use HTTP here as we are hosting our server object under IIS and binary formatter is more efficient over SOAP formatter.
  11. At this stage, if you type the URL http://localhost/Server/Server.soap?wsdl in the explorer address bar (assuming that you are hosting the server object in your local system, else replace "localhost" with valid webserver name), you should see the XML output. This XML is what describes the service that we are hosting under IIS.
  12. It's about time to talk about the client.

ASP.NET Client Application

  1. Create a new ASP.NET web application.
  2. We need a reference to the server object before coding any of the function calls. Now we have several options at this stage, you could actually add the server.dll to the references (even though we are not going to use the local objects, this is the laziest way), create a proxy using soapsuds.exe tool or create an interface and reference that interface. Soapsuds tool has a limitation in that you need to create a proxy for each of the class objects in an assembly. Try the following command at .NET command prompt, you should have "proxy.dll" created for you by soapsuds.exe and you can add a reference to this proxy object. But this will not work for assemblies that encapsulate several classes.

    Image 3

  3. We can also use a more powerful WSDL.exe tool to create proxy class source code which can be included in the project. The remote objects can be created as if they are local to the client.

    Image 4

    If you open this file, you will find the URL, http://localhost/server/server.soap in the class constructor. This proxy class will also have other methods like BegingetServerTime and EndgetServerTime which are used for making asynchronous calls.

  4. The other recommended method is to use Interfaces as we are doing in this case. In the client ASP.NET project, add a reference to the ISever.dll.
  5. Type...
    VB.NET
    Imports System.Runtime.Remoting

    ... at the top of the page to use .NET remoting infrastructure.

  6. Now type the following code in the Page_Load event of the WebForm1.
    VB.NET
    Private Sub Page_Load(ByVal sender As System.Object, _
                       ByVal e As System.EventArgs) Handles MyBase.Load
    
        Dim objRemote As IServer.IServer
    
        'Getting transparent proxy 
        objRemote = Activator.GetObject(GetType(IServer.IServer), _
                      "http://localhost/server/server.soap")
    
        'Executing remote object function
        Response.Write(objRemote.getServerTime())
    
    End Sub
  7. Press F5 to execute and you should see the time displayed.

Points of Interest

You may be surprised that there is no mention of Client.exe.config or Global.aspx files so far. Client.exe.config file is required only when you want to use "new" operator instead of Activator.GetObject method. Having this file is a good idea when the server hosting remote objects is changing often and your code will execute normally by modifying ObjectUri in client.exe.config file without recompiling the server objects. This can also be achieved (as I do) by specifying remote object's URL as key under appSettings tag in web.config. This technique is extremely useful when copying projects from development/testing to production environment, all that you have to do is modify these config files to change the remote object's URL!

Another important aspect to remember is, if you want to pass custom class objects as parameters between the client and server application, these objects should be serialized at one end and deserialized at the other end. This can be achieved by implementing ISerializable interface or by implementing your own methods to convert objects into byte arrays.

References

  1. Absolute beginner's introduction to remoting
  2. Simple but potentially useful example of .NET Remoting
  3. .NET Remoting - Basic Maneuvers
  4. MSDN

History

  • 3rd March, 2005: Initial post
  • 1st August, 2009: Updated download file

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Web Developer
Australia Australia
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
General'The remote server returned an error: (404) Not Found Pin
fipil23-Mar-05 5:46
fipil23-Mar-05 5:46 
GeneralRe: 'The remote server returned an error: (404) Not Found Pin
Raj Settipalli28-Mar-05 11:59
Raj Settipalli28-Mar-05 11:59 
GeneralRe: 'The remote server returned an error: (404) Not Found Pin
Raj Settipalli28-Mar-05 12:01
Raj Settipalli28-Mar-05 12:01 
GeneralRe: 'The remote server returned an error: (404) Not Found Pin
nitinpai20009-Oct-08 0:38
nitinpai20009-Oct-08 0:38 
AnswerRe: 'The remote server returned an error: (404) Not Found Pin
Sarvesh Gupta24-Feb-09 1:59
Sarvesh Gupta24-Feb-09 1:59 
GeneralRe: 'The remote server returned an error: (404) Not Found Pin
HighCommand23-Dec-09 20:40
HighCommand23-Dec-09 20:40 
AnswerRe: 'The remote server returned an error: (404) Not Found Pin
Raj Settipalli23-Dec-09 22:07
Raj Settipalli23-Dec-09 22:07 
GeneralRe: 'The remote server returned an error: (404) Not Found Pin
HighCommand12-Jan-10 0:27
HighCommand12-Jan-10 0:27 
GeneralIServer.dll Pin
RandomHavoc14-Mar-05 7:20
RandomHavoc14-Mar-05 7:20 
GeneralRe: IServer.dll Pin
Raj Settipalli14-Mar-05 12:28
Raj Settipalli14-Mar-05 12:28 
GeneralRe: IServer.dll Pin
RandomHavoc14-Mar-05 14:19
RandomHavoc14-Mar-05 14:19 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.