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 10, Windows 8.1, Windows 7

Reference

LayerFactory Class
LayerFactory Members
Overload List