Click here to Skip to main content
14,541,889 members

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

Rate this:
4.13 (20 votes)
Please Sign up or sign in to vote.
4.13 (20 votes)
2 Aug 2009CPOL
Simplest method to host remote component under IIS with ASP.NET application as client


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.


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.
    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 version="1.0" encoding="utf-8" ?>
                <wellknown mode="Singleton" type="Server.clsServer,
                           Server" objectUri="server.soap" />
                <channel ref="http" />
                    <formatter href="binary" />
  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...
    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), _
        'Executing remote object function
    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.


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


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


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


About the Author

Raj Settipalli
Web Developer
Australia Australia
No Biography provided

Comments and Discussions

QuestionWhy is my example not working? Pin
PraveenBalanagendra21-Feb-13 11:31
MemberPraveenBalanagendra21-Feb-13 11:31 
Generalcool Pin
Mubi | www.mrmubi.com3-Aug-09 10:11
professionalMubi | www.mrmubi.com3-Aug-09 10:11 
Generalu just copied others work Pin
RAINBOW00727-Feb-08 23:23
MemberRAINBOW00727-Feb-08 23:23 
GeneralRe: u just copied others work Pin
Raj Settipalli27-Feb-08 23:33
MemberRaj Settipalli27-Feb-08 23:33 
QuestionProblem with .NET 2.0 :( Pin
ajai808521-Sep-07 3:58
Memberajai808521-Sep-07 3:58 
GeneralEasy to understand, great article Pin
DeRoseNet16-May-07 11:59
MemberDeRoseNet16-May-07 11:59 
QuestionWhat if server assemble containe more than one class Pin
san.vb26-Feb-07 0:39
Membersan.vb26-Feb-07 0:39 
AnswerRe: What if server assemble containe more than one class Pin
Raj Settipalli26-Feb-07 13:19
MemberRaj Settipalli26-Feb-07 13:19 
QuestionCannot load type Pin
distressedflesh6-Feb-07 17:47
Memberdistressedflesh6-Feb-07 17:47 
QuestionChange in .net 2.0? Pin
fleclerc213-Nov-06 0:34
Memberfleclerc213-Nov-06 0:34 
GeneralDoesnt work on a live website Pin
HemalRathod19-Aug-06 0:37
MemberHemalRathod19-Aug-06 0:37 
GeneralRe: Doesnt work on a live website Pin
Raj Settipalli24-Aug-06 11:21
MemberRaj Settipalli24-Aug-06 11:21 
GeneralStrange problem Pin
Het210925-Jul-06 1:54
MemberHet210925-Jul-06 1:54 
GeneralRe: Strange problem Pin
Raj Settipalli25-Jul-06 20:36
MemberRaj Settipalli25-Jul-06 20:36 
GeneralEvent Handler Pin
aahmed1922-Jan-06 16:19
Memberaahmed1922-Jan-06 16:19 
QuestionHow about using Client Activated Object Pin
David Bartolome19-Sep-05 6:00
sussDavid Bartolome19-Sep-05 6:00 
AnswerRe: How about using Client Activated Object Pin
Raj Settipalli19-Sep-05 12:49
MemberRaj Settipalli19-Sep-05 12:49 
General(405) Method Not Allowed Pin
xty_ceron29-Jun-05 9:46
Memberxty_ceron29-Jun-05 9:46 
GeneralRe: (405) Method Not Allowed Pin
ajai808521-Sep-07 4:00
Memberajai808521-Sep-07 4:00 
GeneralCannot load type Server.clsServer, Server Pin
prasanth_at_mbt31-Mar-05 1:14
Memberprasanth_at_mbt31-Mar-05 1:14 
GeneralRe: Cannot load type Server.clsServer, Server Pin
prasanth_at_mbt31-Mar-05 1:19
Memberprasanth_at_mbt31-Mar-05 1:19 
GeneralRe: Cannot load type Server.clsServer, Server Pin
Anonymous31-Mar-05 14:19
MemberAnonymous31-Mar-05 14:19 
GeneralRe: Cannot load type Server.clsServer, Server Pin
prasanth_at_mbt31-Mar-05 18:38
Memberprasanth_at_mbt31-Mar-05 18:38 
GeneralRe: Cannot load type Server.clsServer, Server Pin
Raj Settipalli31-Mar-05 19:00
MemberRaj Settipalli31-Mar-05 19:00 
GeneralRe: Cannot load type Server.clsServer, Server Pin
mikecran15-Apr-05 5:15
Membermikecran15-Apr-05 5:15 

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.

Posted 3 Mar 2005


53 bookmarked