This document is archived and information here might be outdated.  Recommended version.

ILayerDescription Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Carto > ESRI.ArcGIS.Carto > Interfaces > IL > ILayerDescription Interface
ArcGIS Developer Help

ILayerDescription Interface

Provides access to the available properties of a layer description object. Note: the ILayerDescription interface has been superseded by ILayerDescription3. Please consider using the more recent version.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

When To Use

Use the ILayerDescription interface to access read and write properties of a layer.


Name Description
Read/write property DefinitionExpression The definition expression for the layer.
Read/write property ID The layer ID. This is a unique ID for the layer, and is used to identify the layer in a number of method calls.
Read/write property ScaleSymbols Indicates whether the layer should scale its symbols according to the reference scale.
Read/write property SelectionBufferDistance The selection buffer distance. When drawing, and if a selection filter is specified, a buffer zone of the specified distance will be displayed around the selected features.
Read/write property SelectionColor The selection color (used when SetSelectionSymbol = FALSE).
Read/write property SelectionFeatures Array of selected features.
Read/write property SelectionSymbol The selection symbol.
Read/write property SetSelectionSymbol Indicates if the selected set of features is drawn using the SelectionSymbol.
Read/write property ShowLabels Indicates whether the layer should display its dynamic labels.
Read/write property ShowSelectionBuffer Indicates whether the selection buffer should be displayed.
Read/write property Visible Indicates whether the layer is visible as defined in the TOC (i.e. marked on).

Classes that implement ILayerDescription

Classes Description
LayerDescription The Layer Description coclass contains settings of a layer in a map.


Please note the difference of use between IMapLayerInfo and ILayerDescription: Use ILayerDescription to access layer settings that can be changed on the server object without changing the state of the underlying fine-grained ArcObjects that the layer is based on. MapLayerInfo is used to retrieve information about a layer that can only be changed by directly accessing the map document or the fine-grained ArcObjects it is based on.

In some cases you may want limit or adjust the geometry being returned in the find result. This can be done for performance reasons. Use ILayerResultOptions to manage this. If IncludeGeometry is set to False, FeatureShape returns nothing. This should increase performance in cases where feature geometry is large. You can also choose to densify or generalize the geometry returned in FeatureShape using GeometryResultOptions. Densification is used to better support clients that do not support Arcs (e.g. Bezier, Circular etc.). Generalization reduces the amount of geography being sent across the network and should lead to better performance. If LayerResultOptions are not specified for the LayerDescription, query results will include the original geometry.