Method CreateAsync
CreateAsync(UtilityNetwork, UtilityAssetType)
Analyzes a UtilityNetwork for the rules which allow or limit the snapping of the given UtilityAssetType to other features, and returns a SnapRules which can be used to configure interactive snapping behavior in a GeometryEditor.
Declaration
public static Task<SnapRules> CreateAsync(UtilityNetwork utilityNetwork, UtilityAssetType assetType)Parameters
| Type | Name | Description |
|---|---|---|
| UtilityNetwork | utilityNetwork | The UtilityNetwork object to analyze for its connectivity rules relating to the given assetType. |
| UtilityAssetType | assetType | The asset type of the feature geometry that will be edited in the GeometryEditor. Connectivity rules involving this asset type are included in the returned SnapRules. |
Returns
| Type | Description |
|---|---|
| System.Threading.Tasks.Task<SnapRules> | A SnapRules appropriate for interactively editing the geometry of a feature of the given UtilityAssetType. |
Remarks
To configure rule-based snapping, use this method to create a SnapRules that you can then pass to SyncSourceSettings(SnapRules, SnapSourceEnablingBehavior). This method is ideal for creating SnapRules when you have a reference to the UtilityAssetType, for example if you have identified an existing feature to be edited, you can call CreateElement(ArcGISFeature), then get AssetType to pass in.
Ensure that the feature tables underlying the given UtilityNetwork are the same used by operational layers in the map, so that the SnapRules are based on the same underlying data sets.
If your map view displays a web map, or is set from a MobileMapPackage, the UtilityNetworks collection may already contain the relevant utility network object to use. Alternatively you may get the utility network from the same Geodatabase that backs your operational layers, or call UtilityNetwork(Uri, Map) to create the network from a feature service URI and associate it with your Map.
Ensure that the UtilityAssetType is from the given UtilityNetwork.
Applies to
Platforms and versions
| Target | Versions |
|---|---|
| .NET Standard 2.0 | 200.7 |
| .NET | 200.7 |
| .NET Windows | 200.7 |
| .NET Android | 200.7 |
| .NET iOS | 200.7 |
| .NET Framework | 200.7 |
| UWP | 200.7 |
CreateAsync(UtilityNetwork, FeatureTable, IEnumerable<KeyValuePair<String, Object>>)
Analyzes a UtilityNetwork for the rules which allow or limit the snapping of a feature in the given featureTable with the given attributes, and returns a SnapRules which can be used to configure interactive snapping behavior in a GeometryEditor.
Declaration
public static Task<SnapRules> CreateAsync(UtilityNetwork utilityNetwork, FeatureTable featureTable, IEnumerable<KeyValuePair<string, object>> attributes)Parameters
| Type | Name | Description |
|---|---|---|
| UtilityNetwork | utilityNetwork | The UtilityNetwork object to analyze for its connectivity rules relating to a feature of the asset type described by the given featureTable and attributes. |
| FeatureTable | featureTable | The feature table that will contain the feature whose geometry will be edited in the GeometryEditor using the returned SnapRules. Must be part of the given utilityNetwork. |
| System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<System.String, System.Object>> | attributes | The attributes for the feature whose geometry will be edited in the GeometryEditor using the returned SnapRules. |
Returns
| Type | Description |
|---|---|
| System.Threading.Tasks.Task<SnapRules> | A SnapRules appropriate for interactively editing the geometry of a feature in the given featureTable with the given attributes. |
Remarks
To configure rule-based snapping, use this method to create a SnapRules that you can then pass to SyncSourceSettings(SnapRules, SnapSourceEnablingBehavior). This method is ideal for creating SnapRules where you have a set of attributes, for example, if you are creating a new feature from a FeatureTemplate or by using a FeatureForm. Connectivity rules involving the UtilityAssetType of the feature are described by those attributes are included in the resulting rules.
Ensure that the feature tables underlying the given UtilityNetwork are the same used by operational layers in the map, so that the SnapRules are based on the same underlying data sets.
If your map view displays a web map, or is set from a MobileMapPackage, the UtilityNetworks collection may already contain the relevant utility network object to use. Alternatively you may get the utility network from the same Geodatabase that backs your operational layers, or call UtilityNetwork(Uri, Map) to create the network from a feature service URI and associate it with your Map.
Applies to
Platforms and versions
| Target | Versions |
|---|---|
| .NET Standard 2.0 | 200.7 |
| .NET | 200.7 |
| .NET Windows | 200.7 |
| .NET Android | 200.7 |
| .NET iOS | 200.7 |
| .NET Framework | 200.7 |
| UWP | 200.7 |