Class SubtypeFeatureLayer
A layer that can visualize feature data with different visibility, rendering, popup properties, and so on for some or all of the subtypes in an ArcGISFeatureTable.
Implements
Namespace: Esri.ArcGISRuntime.Mapping
Assembly: Esri.ArcGISRuntime.dll
Syntax
public sealed class SubtypeFeatureLayer : FeatureLayer, INotifyPropertyChanged, ILoadable, ILayerContent, IPopupSource, ITimeAware, IFloorAware
Remarks
The ArcGISFeatureTable must have a SubtypeField defined, and at least one FeatureSubtype defined, otherwise the layer will fail to load.
Subtypes provide a way to organize your data within an ArcGIS feature table. For example, the streets in a city streets feature table could be categorized into three subtypes - local streets, collector streets, and arterial streets. The benefit of the subtype feature layer is that it allows you to configure different layer properties per subtype. This is particularly useful for data, such as utility networks, in which many different network elements are grouped into a single subtype feature layer.
Functional characteristics
The subtype feature layer acts like a group layer that automatically creates one feature layer, or subtype sublayer, for each subtype in the table. Each subtype sublayer can be configured independently of one another. They can have different renderers, label definitions, max and min scales, visibility, layer order in the map, and so on. When a subtype group layer is read from a web map or mobile map, it is represented as a SubtypeFeatureLayer. Saving a map that contains a SubtypeFeatureLayer will save the layer as a subtype group layer. SubtypeFeatureLayers are supported in offline maps and will work in offline editing workflows.
Performance characteristics
Queries are optimized across all sublayers. For example, a pan of the map sends a single request to the feature table to cover all the sublayers. If you had manually created a feature layer for each subtype, this would have resulted in one query per feature layer.
Sample Code:
Constructors
Name | Description |
---|---|
SubtypeFeatureLayer(ArcGISFeatureTable) | Initializes a new instance of the SubtypeFeatureLayer class. |
SubtypeFeatureLayer(Item, Int64) | Initializes a new instance of the SubtypeFeatureLayer class from a feature service portal item. |
Properties
Name | Description |
---|---|
SubtypeSublayers | Gets the mutable collection of SubtypeSublayer. |
Methods
Name | Description |
---|---|
GetSublayerBySubtypeCode(Object) | Finds a SubtypeSublayer for a feature subtype based on the Code. |
GetSublayerBySubtypeName(String) | Finds a SubtypeSublayer for a feature subtype based on the subtype name. |
See Also
Applies to
Target | Versions |
---|---|
.NET Standard 2.0 | 100.7 - 100.15 |
.NET 6.0 | 100.13 - 100.15 |
.NET 6.0 Windows | 100.13 - 100.15 |
.NET Framework | 100.7 - 100.15 |
.NET 5 | 100.10 - 100.12 |
.NET Core 3.1 | 100.7 - 100.12 |
Xamarin.Android | 100.7 - 100.15 |
Xamarin.iOS | 100.7 - 100.15 |
UWP | 100.7 - 100.15 |