EDN Code Exchange

Updated Sep 29, 2010
Samples

Accessing server objects using GISClient

Description:

The sample is a simple desktop application that allows you to connect to a GIS server directly over a LAN, or indirectly via a web service catalog over the internet and browse the MapServers running in the server or explosed in the web service catalog, draw their data frames, navigate their bookmarks and to some simple zooming. This sample demostrates how you can use the GISClient objects to work with server objects and ArcGIS Server web services using the same API.
ArcGIS Desktop and ArcGIS Engine developers can consume ArcGIS Server web services using the ArcGIS Server Client API (AGSClient) which is in the GISClient object library. The AGSClient includes objects and methods for connecting to GIS servers either directly or through web service catalogs to make use of MapServer and GeocodeServer objects. The AGSClient differs from the server API in that it restricts clients to calling only the coarse-grained methods on the server object, and does not provide access to the finer-grained ArcObjects associated with a server object.
The GISClient objects can be used to connect to a GIS server either via a LAN connection (by specifying the machine property in the connection), or via a web service catalog (by providing the URL property in the connection). The GISClient object provides a uniform programming interface for working with server objects through both LAN connections and web service connections.
In order to use this sample, you must have the ArcGIS Engine, ArcGIS Desktop installed on the client machine that you will run the application on. You must also have an ArcGIS Server or URL to an ArcGIS Server web service catalog to connect to that has map server objects running on it.
Products:

Engine: VB6, C#, VB.NET

Platforms: Windows

Minimum ArcGIS Release: 9.0

How to use:
[VB6]
  1. Open the MapServerBrowser.vbp and run from within the project.
  2. Type the name of you GIS server, then click Connect.
  3. Click the MapServer dropdowsn, snd choose a MapServer to work with.
  4. Use the Data Frame and Bookmark dropdown to explore the MapServer.
  5. Use the ZoomIn, ZoomOut buttons to interactivly zoom in and out fixed amounts
[C#]
  1. Open the MapServerBrowser.sln and run from within the project.
  2. Type the name of you GIS server, then click Connect.
  3. Click the MapServer dropdowsn, snd choose a MapServer to work with.
  4. Use the Data Frame and Bookmark dropdown to explore the MapServer.
  5. Use the ZoomIn, ZoomOut buttons to interactivly zoom in and out fixed amounts
[VB.NET]
  1. Open the MapServerBrowser.sln and run from within the project.
  2. Type the name of you GIS server, then click Connect.
  3. Click the MapServer dropdowsn, snd choose a MapServer to work with.
  4. Use the Data Frame and Bookmark dropdown to explore the MapServer.
  5. Use the ZoomIn, ZoomOut buttons to interactivly zoom in and out fixed amounts

File Description
MapServerBrowser.exe The compiled project executable.
MapServerBrowser.vbp VB project file.
BrowseMaps.frm
(view code)
 VB form file for the BrowseMaps project.
Images Directory containing the images for the toolbar buttons.
File Description
MapServerBrowser.exe The compiled project executable.
MapServerBrowser.sln The solution file.
MapServerBrowser.csproj The project file.
Form1.cs
(view code)
 C# form file for the BrowseMaps project.
Images Directory containing the images for the toolbar buttons.
File Description
MapServerBrowser.exe The compiled project executable.
MapServerBrowser.sln The solution file.
MapServerBrowser.vbproj The project file.
Form1.vb
(view code)
 VB.NET form file for the BrowseMaps project.
Images Directory containing the images for the toolbar buttons.



Key Libraries: GISClient, Carto, Geometry, System
Key CoClasses:AGSServerConnection, MapServer, MapDescription
Key Interfaces: IAGSServerConnection, IMapServer, IMapDescription, IMapServerBookmarks