CreateFeatureLayer(CIMDataConnection,ILayerContainerEdit,Int32,String,RendererDefinition) Method

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

Syntax

C#
Visual Basic (Declaration)

public FeatureLayer CreateFeatureLayer( 
   CIMDataConnection dataConnection,
   ILayerContainerEdit mapOrGroupLayer,
   int index,
   string layerName,
   RendererDefinition rendererDefinition
)

Public Overloads Function CreateFeatureLayer( _
   ByVal dataConnection As CIMDataConnection, _
   ByVal mapOrGroupLayer As ILayerContainerEdit, _
   ByVal index As Integer, _
   Optional ByVal layerName As String, _
   Optional ByVal rendererDefinition As RendererDefinition _
) As FeatureLayer

Parameters

dataConnection: A CIMDataConnection
mapOrGroupLayer: A map or group layer instance to which the Feature Layer will be added
index: The position of the Feature 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 = "")
rendererDefinition: (optional) Provide a RendererDefinition to create a FeatureLayer with your custom renderer instead of the default renderer that gets generated automatically. (default value = null)

Return Value

FeatureLayer

Exceptions

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

Example

Create a query layer.

await QueuedTask.Run(() =>
{
  Map map = MapView.Active.Map;
  Geodatabase geodatabase = new Geodatabase(new DatabaseConnectionFile(new Uri(@"C:\Connections\mySDE.sde")));
  CIMSqlQueryDataConnection sqldc = new CIMSqlQueryDataConnection()
  {
    WorkspaceConnectionString = geodatabase.GetConnectionString(),
    GeometryType = esriGeometryType.esriGeometryPolygon,
    OIDFields = "OBJECTID",
    Srid = "102008",
    SqlQuery = "select * from MySDE.dbo.STATES",
    Dataset = "States"
  };
  FeatureLayer flyr = (FeatureLayer)LayerFactory.Instance.CreateLayer(sqldc, map, layerName: "States");
});

Requirements

Target Platforms: Windows 11, Windows 10, Windows 8.1

Reference

LayerFactory Class
LayerFactory Members
Overload List