Click here to Skip to main content
Click here to Skip to main content
Go to top

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

, 2 Aug 2009
Rate this:
Please Sign up or sign in to vote.
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.
    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.
    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.
  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 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.

  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.

    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...
    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.
    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)

Share

About the Author

Raj Settipalli
Web Developer
Australia Australia
No Biography provided

Comments and Discussions

 
QuestionWhy is my example not working? PinmemberPraveenBalanagendra21-Feb-13 11:31 
Generalcool PinmemberMubi | www.mrmubi.com3-Aug-09 10:11 
Generalu just copied others work PinmemberRAINBOW00727-Feb-08 23:23 
GeneralRe: u just copied others work PinmemberRaj Settipalli27-Feb-08 23:33 
QuestionProblem with .NET 2.0 :( Pinmemberajai808521-Sep-07 3:58 
GeneralEasy to understand, great article Pinmemberrderose16-May-07 11:59 
QuestionWhat if server assemble containe more than one class Pinmembersan.vb26-Feb-07 0:39 
AnswerRe: What if server assemble containe more than one class PinmemberRaj Settipalli26-Feb-07 13:19 
QuestionCannot load type Pinmemberdistressedflesh6-Feb-07 17:47 
QuestionChange in .net 2.0? Pinmemberfleclerc213-Nov-06 0:34 
GeneralDoesnt work on a live website PinmemberHemalRathod19-Aug-06 0:37 
GeneralRe: Doesnt work on a live website PinmemberRaj Settipalli24-Aug-06 11:21 
GeneralStrange problem PinmemberHet210925-Jul-06 1:54 
GeneralRe: Strange problem PinmemberRaj Settipalli25-Jul-06 20:36 
GeneralEvent Handler Pinmemberaahmed1922-Jan-06 16:19 
QuestionHow about using Client Activated Object PinsussDavid Bartolome19-Sep-05 6:00 
AnswerRe: How about using Client Activated Object PinmemberRaj Settipalli19-Sep-05 12:49 
General(405) Method Not Allowed Pinmemberxty_ceron29-Jun-05 9:46 
GeneralRe: (405) Method Not Allowed Pinmemberajai808521-Sep-07 4:00 
I too got the same error when i try with different name for the objURI to some thing else . it will work only with .soap or .rem if you give some thing else then same error will get
 
Warm Regards
Ajai NP

GeneralCannot load type Server.clsServer, Server Pinsusspv12345631-Mar-05 1:14 
GeneralRe: Cannot load type Server.clsServer, Server Pinsusspv12345631-Mar-05 1:19 
GeneralRe: Cannot load type Server.clsServer, Server PinsussAnonymous31-Mar-05 14:19 
GeneralRe: Cannot load type Server.clsServer, Server Pinsusspv12345631-Mar-05 18:38 
GeneralRe: Cannot load type Server.clsServer, Server PinsussRaj Settipalli31-Mar-05 19:00 
GeneralRe: Cannot load type Server.clsServer, Server Pinmembermikecran15-Apr-05 5:15 

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

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

| Advertise | Privacy | Mobile
Web02 | 2.8.140916.1 | Last Updated 2 Aug 2009
Article Copyright 2005 by Raj Settipalli
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid