ArcGIS Pro 3.8 API Reference Guide
ArcGIS.Desktop.Mapping Namespace / UniqueValueRendererDefinition Class / ValueFields Property
Example

In This Topic
    ValueFields Property (UniqueValueRendererDefinition)
    In This Topic
    Gets or sets one or more fields to be used to get unique values or combination of values from. This is required if ArcadeExpression is null.
    Syntax
    public List<string> ValueFields {get; set;}
    Public Property ValueFields As List(Of String)
    Example
    Unique Value Renderer for a feature layer
    /// <summary>
    /// Renders a feature layer using unique values from one or multiple fields
    /// ![Unique Value renderer](https://ArcGIS.github.io/arcgis-pro-sdk/images/Renderers/unique-value.png)
    /// </summary>
    {
      //Check feature layer name
      //Code works with the USDemographics feature layer available with the ArcGIS Pro SDK Sample data
      var featureLayer = activeMap.GetLayersAsFlattenedList().OfType<FeatureLayer>().FirstOrDefault(f => f.Name == "USDemographics");
      if (featureLayer == null)
      {
        MessageBox.Show("This renderer works with the USDemographics feature layer available with the ArcGIS Pro SDK Sample data", "Data missing");
      }
      //construct unique value renderer definition
      UniqueValueRendererDefinition uvr = new
               UniqueValueRendererDefinition()
      {
        //Refer to the function below to get a display field of the feature layer
        ValueFields = new List<string> { await GetDisplayFieldAsync(featureLayer) }, //multiple fields in the array if needed.
        ColorRamp = colorRamp, //Specify color ramp
      };
    
      //Creates a "Renderer"
      await QueuedTask.Run(() =>
      {
        var cimRenderer = featureLayer.CreateRenderer(uvr);
    
        //Sets the renderer to the feature layer
        featureLayer.SetRenderer(cimRenderer);
      });
    
      //Function to get the display field of a feature layer
      static Task<string> GetDisplayFieldAsync(FeatureLayer featureLayer)
      {
        return QueuedTask.Run(() =>
        {
          // get the CIM definition from the layer
          var cimFeatureDefinition = featureLayer.GetDefinition() as ArcGIS.Core.CIM.CIMBasicFeatureLayer;
          // get the view of the source table underlying the layer
          var cimDisplayTable = cimFeatureDefinition.FeatureTable;
          // this field is used as the 'label' to represent the row
          return cimDisplayTable.DisplayField;
        });
      }
    }
    Defining a unique value renderer definition
    {
      await QueuedTask.Run(() =>
      {
        streamLayer = null;
        //https://geoeventsample1.esri.com:6443/arcgis/rest/services/AirportTraffics/StreamServer
    
        var uvrDef = new UniqueValueRendererDefinition()
        {
          ValueFields = new List<string> { "ACTYPE" },
          SymbolTemplate = SymbolFactory.Instance.ConstructPointSymbol(
            ColorFactory.Instance.RedRGB, 10, SimpleMarkerStyle.Hexagon)
              .MakeSymbolReference(),
          ValuesLimit = 5
        };
        //Note: CreateRenderer can only create value classes based on
        //the current events it has received
        streamLayer.SetRenderer(streamLayer.CreateRenderer(uvrDef));
      });
    }
    Requirements

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

    ArcGIS Pro version: 3.0 or higher.
    See Also