ArcGIS Pro 3.8 API Reference Guide
ArcGIS.Desktop.Mapping Namespace / BulkMapMemberCreationParams Class / AutoGroup Property
Example

In This Topic
    AutoGroup Property
    In This Topic
    Gets and sets whether the map members being created should be automatically grouped
    Syntax
    public virtual Nullable<bool> AutoGroup {get; set;}
    Public Overridable Property AutoGroup As Nullable(Of Boolean)
    Remarks
    A value of null means that auto-grouping for the bulk create will retain its pre-3.8 autogrouping behavior
    Example
    Create multiple layers with BulkLayerCreationParams 1 - No AutoGroup
    {
      // same example as "Create multiple layers with BulkLayerCreationParams 1" but without
      //   adding layers in a group layer
    
      //Uris to the datasets for the layers to be created
      var uriShp = new Uri(@"c:\data\roads.shp");
      var uriSde = new Uri(@"c:\MyDataConnections\MySDE.sde\Census");
      var uri = new Uri(@"http://sampleserver6.arcgisonline.com/arcgis/rest/services/NapervilleShelters/FeatureServer/0");
      // Create a list of URIs to be used for creating multiple layers
      var uris = new List<Uri>() { uriShp, uriSde, uri };
      ;
    
      // set the index and visibility
      var blkParams = new BulkLayerCreationParams(uris);
      blkParams.MapMemberPosition = MapMemberPosition.Index;
      blkParams.MapMemberIndex = 2;
      blkParams.IsVisible = false;
      blkParams.AutoGroup = false;
    
      // Create multiple layers using the BulkLayerCreationParams
      var layers = await QueuedTask.Run(() => LayerFactory.Instance.CreateLayers(blkParams, map));
    }
    Create multiple layers with BulkLayerCreationParams 3 - Valid
    {
      // illustrates using a collection of CIMLayerDocument
    
      var layerFile1 = @"c:\data\CitiesRivers.lyrx";
      var layerfile2 = @"c:\data\StatesWorld.lyrx";
    
      var layerDoc1 = new LayerDocument(layerFile1);
      var cimLayerDoc1 = layerDoc1.GetCIMLayerDocument();
    
      var layerDoc2 = new LayerDocument(layerfile2);
      var cimLayerDoc2 = layerDoc2.GetCIMLayerDocument();
    
      var cimLayerDocs = new List<CIMLayerDocument>() { cimLayerDoc1, cimLayerDoc2 };
    
      var blkParams = new BulkLayerCreationParams(cimLayerDocs);
      blkParams.AutoGroup = true;   // add the layersfiles within an encompassing group layer
    
      var layers = await QueuedTask.Run(() => LayerFactory.Instance.CreateLayers(blkParams, map));
    }
    Requirements

    Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

    ArcGIS Pro version: 3.8 or higher.
    See Also