IMapServerObjects2 Interface

Provides access to core objects contained within the map document. Note: the IMapServerObjects2 interface has been superseded byIMapServerObjects2. Please consider using the more recent version.

Product Availability

When To Use

Use IMapServerObjects to access fine-grained ArcObjects. Through this interface you can access ILayer, IMap and IPageLayout. For example, you can make changes to the map, such as adding a new layer, using the IMap object.

This interface is not supported by optimized MapServer

Members

	All Properties Methods	Description
	ApplyMapDescription	Applies the current state of the map description to the map server object.
	Layer	The layer specified by the map name and layer ID. If the mapName is blank, the default map (active data frame) will be assumed.
	LayerID	The layer specified by the map name and layer ID. If the mapName is blank, the default map (active data frame) will be assumed.
	Map	The map corresponding to the specified map name. Pass in a blank string for mapName to get the default map (active data frame).
	PageLayout	The page layout object for the current map document.
	RefreshServerObjects	Updates the server info based on the current state of the underlying fine-grained objects.
	Thumbnail	The thumbnail stored in the map document.

CoClasses that implement IMapServerObjects2

Remarks

Though the methods and properties available through MapServer and its associated objects offer important mapping functionality, they cannot possibly encapsulate all that ArcObjects offers. In many cases you may want to use other, finer-grained, ArcObjects in conjunction with MapServer. You can do this using the IMapServerObjects2 interface. Through this interface you can access ILayer, IMap and IPageLayout. For example, you can make changes to the map, such as adding a new layer, using IMap.

It is very important to distinguish between temporary and permanent changes to the MapServer object. A temporary change would include changes to the MapDescription or LayerDescription using IMapDescription2 and ILayerDescription3. For example, you might change the geographic extent of a map (MapArea) or change the visibility of a layer (Visible). These changes can be temporary and valid for the duration of the call. Once the call has ended the MapServer object returns to it's default state.

Permanent changes to the MapServer object can be done in two ways.  The first is by changing MapServer properties using such interfaces as IMapDescription and ILayerDescription and then calling the IMapServerObjects method ApplyMapDescription. This will update the state of the MapServer object. Another way to change the MapServer object is to access the underlaying fine-grained ArcObjects directly using the methods on IMapServerObjects, make a change such as adding a new layer or changing a layer's rendering, and then calling RefreshServerObjects. This refreshes the MapServer object with the current state held by the fine-grained ArcObjects.

If the underlying fine-grained ArcObjects are to be changed, MapServer objects should be in a non-pooled configuration.