How To Create Client Access to Remote Server by Using Visual Basic .NET

This article was previously published under Q300943
This article has been archived. It is offered "as is" and will no longer be updated.
The following .NET Framework Class Library namespace is referenced in this article:

This article discusses a Beta release of a Microsoft product. The information in this article is provided as-is and is subject to change without notice.

No formal product support is available from Microsoft for this Beta product. For information about how to obtain support for a Beta release, see the documentation that is included with the Beta product files, or check the Web location from which you downloaded the release.

For a Microsoft Visual C# .NET version of this article, see 307739.
For a Microsoft Visual Basic 6.0 version of this article, see 266717.


This step-by-step procedure demonstrates how to create a client that accesses a remote server. This client can be located on the same computer, on a different computer, or on a different network. This article builds upon the following Microsoft Knowledge Base article:
300951 How To Create a Remote Server by Using Visual Basic .NET
back to the top


The following list outlines the recommended hardware, software, network infrastructure, and service packs that you need:
  • Microsoft Windows 2000 Professional, Windows 2000 Server, Windows 2000 Advanced Server, or Windows NT 4.0 Server
  • Microsoft Visual Studio .NET
This article assumes that you are familiar with the following topics:
  • Visual Studio .NET
  • Networking
You must also build applications that are described in 300951 before you begin the procedure in this article.

back to the top

How to Create a Client to a Remote Server

  1. Create a new Console Application in Visual Basic .NET. Module1 is created by default.
  2. Rename the module from Module1.vb to ClientApp.vb.
  3. Add a reference to the System.Runtime.Remoting namespace to the project.
  4. Add a reference to the ServerClass.dll assembly that you created in 300951.

    There are three different ways for a client to reference remote objects, and each of these is resolved at compile time. This example uses the first option (a).
    1. Compile the server object, and specify the .exe or .dll file as a reference to the compiler when you compile the client. This method is useful when both the client and server components are developed at the same site.
    2. Derive the server object from an interface class, and compile the client with the interface. This method is useful when the client and server components are not developed at the same site. The interface(s) can be compiled to a dynamic-link library (DLL) and shipped to the client sites as necessary. As much as possible, avoid changing a published interface.
    3. Use the SoapSUDS tool to extract the required metadata from a running server object. This method is useful when client and server components are developed at different sites, and no interface classes are available. Point the SoapSUDS tool at a remote Uniform Resource Identifier (URI), and generate the required metadata as source or a DLL. It is important to note that the SoapSUDS tool only extracts metadata; it does not generate the source for the remote object.
  5. Use the Imports statement on the Remoting, Remoting.Channels, and Remoting.Channels.Tcp namespaces and the ServerClass class name so that you are not required to qualify declarations in those namespaces later in your code. You must use the Imports statement prior to any other declarations.
    Imports System.Runtime.RemotingImports System.Runtime.Remoting.ChannelsImports System.Runtime.Remoting.Channels.TcpImports ServerClass					
  6. Declare a variable to initialize a TcpChannel object that the client will use to connect to the server application. Use the RegisterChannel method to register the channel with the channel services. Add the following declaration code in the Main procedure of the main module:
    Dim chan As TcpChannel = New TcpChannel()ChannelServices.RegisterChannel(chan)					
  7. Declare and instantiate the remote server. In this example, use the GetObject method of the Activator object to instantiate the myRemoteClass object, and specify the following parameters in the code:
    1. The full type name of the object that is being registered (which is ServerClass.myRemoteClass in this example), followed by the assembly name ServerClass. Specify both the name of the namespace as well as the classname. Because you did not specify a namespace in the previous section, the default root namepace is used.
    2. Activate the URI of the object. The URI must include the protocol (TCP), the computer name (localhost), the port (8085), and the endpoint of the server object (RemoteTest). To access the ServerClass remote server that is located on the local server, use the URI tcp://localhost:8085/RemoteTest.
    Dim obj As myRemoteClassObj = CType(Activator.GetObject(  _ 	Type.GetType("myRemoteClass, ServerClass"),  _	"tcp://localhost:8085/RemoteTest"), myRemoteClass)If obj Is Nothing Then	Console.WriteLine("Could not locate server")Else	If obj.SetString("Sending String to Server") Then		Console.WriteLine("Success: Check the other console to verify.")	Else		Console.WriteLine("Sending the test string has failed.")	End IfEnd If					
  8. Use the ReadLine method of the Console object to keep the client application running.
    Console.WriteLine("Press <ENTER> to exit...")Console.ReadLine()					
  9. Build your project.
  10. Make sure that the server application is running. (This refers to the .exe file that you created in 300951.)
  11. Run the project, and test the client-to-server communication.
back to the top


For an overview of .NET Remoting, see the Microsoft .NET Framework Developer's Guide documentation.

For more information about the TcpChannel class, see the following .NET Framework Class Library documentation: For more information about Microsoft .NET Remoting, see the following .NET Development (General) technical articles:
"Introduction to the Microsoft .NET Remoting Framework"

"Microsoft .NET Remoting: A Technical Overview"
For more information about the Activator.GetObject method, see the following .NET Framework Class Library documentation: For more information about the Type.GetType method, see the following .NET Framework Class Library documentation: back to the top

Article ID: 300943 - Last Review: 12/06/2015 03:12:27 - Revision: 4.5

Microsoft .NET Framework Class Libraries 1.0, Microsoft Visual Basic .NET 2002 Standard Edition

  • kbnosurvey kbarchive kbhowtomaster kbtunneling KB300943