How to connect to an ArcIMS service

Summary
This topic demonstrates how to connect to an ArcIMS service. The IMSServerConnection abstract base class is implemented by the TCPConnection and HTTPConnection classes to connect via Transfer Control Protocol (TCP) and Hypertext Transfer Protocol (HTTP), respectively. TCP connections must be made to the ArcIMS Application Server. HTTP connections can use both the ArcIMS Servlet connector and the ASP.NET ArcXMLHandler (included with the ArcIMS API), which can serve as endpoints.
A reference to a map service is maintained when creating a MapService instance. A set of initialization parameters can also be provided to define service capabilities. Once a reference to the map service is available, you can create a MapView to work with map service content, such as generating a map image or querying a layer.

Connecting to an ArcIMS service

To connect to an ArcIMS service, follow these steps:
  1. Set up an application with the listed assemblies shown at the end of this topic.
  2. Set the properties of a TCP or HTTP connection to the appropriate values.
See the following code example:
[C#] 
// Using the ArcGIS Connection library—TCP:
ESRI.ArcGIS.ADF.Connection.IMS.TCPConnection tcpConnection = new
    ESRI.ArcGIS.ADF.Connection.IMS.TCPConnection(serverName, 5300);
tcpConnection.ServiceName = serviceName;

// Using the ArcIMS Connection library—HTTP:
ESRI.ArcGIS.ADF.Connection.IMS.HTTPConnection httpConnection = new
    ESRI.ArcGIS.ADF.Connection.IMS.HTTPConnection("http://webservername");
httpConnection.ServiceName = serviceName;

// Using the ArcIMS API:
ESRI.ArcGIS.ADF.IMS.Carto.MapService mapService = new
    ESRI.ArcGIS.ADF.IMS.Carto.MapService(tcpConnection, new
    ESRI.ArcGIS.ADF.IMS.Carto.InitializationParameters(), true);
ESRI.ArcGIS.ADF.IMS.Carto.MapView mapView = mapService.CreateMapView();
[VB.NET] 
' Using the ArcGIS Connection library—TCP:
Dim tcpConnection As ESRI.ArcGIS.ADF.Connection.IMS.TCPConnection = New ESRI.ArcGIS.ADF.Connection.IMS.TCPConnection(serverName, 5300)
tcpConnection.ServiceName = serviceName

' Using the ArcIMS Connection library—HTTP:
Dim httpConnection As ESRI.ArcGIS.ADF.Connection.IMS.HTTPConnection = New ESRI.ArcGIS.ADF.Connection.IMS.HTTPConnection("http://webservername")
httpConnection.ServiceName = serviceName

' Using the ArcIMS API:
Dim mapService As ESRI.ArcGIS.ADF.IMS.Carto.MapService = New ESRI.ArcGIS.ADF.IMS.Carto.MapService(tcpConnection, New ESRI.ArcGIS.ADF.IMS.Carto.InitializationParameters(), True)
Dim mapView As ESRI.ArcGIS.ADF.IMS.Carto.MapView = mapService.CreateMapView()





To use the code in this topic, reference the following assemblies in your Visual Studio project. In the code files, you will need using (C#) or Imports (VB .NET) directives for the corresponding namespaces (given in parenthesis below if different from the assembly name):