CreateLayer(Item,ILayerContainerEdit,Int32,String) Method

Overloaded. Creates a new Layer instance using the specified Item and adds that to a container such as a map or group layer. Optionally you can provide a name to override the default display name. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public Layer CreateLayer( 
   Item item,
   ILayerContainerEdit mapOrGroupLayer,
   int index,
   string layerName
)

Public Overloads Function CreateLayer( _
   ByVal item As Item, _
   ByVal mapOrGroupLayer As ILayerContainerEdit, _
   ByVal index As Integer, _
   Optional ByVal layerName As String _
) As Layer

Parameters

item: An ArcGIS.Desktop.Core.Item
mapOrGroupLayer: A map or group layer instance to which the Layer will be added
index: The position of the layer in the map or group layer. 0 represents the top most position.
layerName: (optional) When it is not provided, the default display name gets used e.g. the dataset name or alias. (default value = "")

Return Value

Layer

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.

Remarks

You should always check using LayerFactory.Instance.CanCreateLayerFrom() method before passing an item to this method.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 7

Reference

LayerFactory Class
LayerFactory Members
Overload List