This document is archived and information here might be outdated.  Recommended version.


IBasicGeoprocessor.Dissolve Method (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (Carto)  

IBasicGeoprocessor.Dissolve Method

Dissolves features.

[Visual Basic .NET]
Public Function Dissolve ( _
    ByVal inputTable As ITable, _
    ByVal useSelected As Boolean, _
    ByVal dissolveField As String, _
    ByVal summaryFields As String, _
    ByVal outputName As IDatasetName _
) As ITable
[C#]
public ITable Dissolve (
    ITable inputTable,
    bool useSelected,
    string dissolveField,
    string summaryFields,
    IDatasetName outputName
);
[C++]
HRESULT Dissolve(
  ITable* inputTable,
  VARIANT_BOOL useSelected,
  BSTR dissolveField,
  BSTR summaryFields,
  IDatasetName* outputName,
  ITable** resultTable
);
[C++]

Parameters inputTable [in]
inputTable is a parameter of type ITable useSelected [in] useSelected is a parameter of type VARIANT_BOOL dissolveField [in] dissolveField is a parameter of type BSTR summaryFields [in] summaryFields is a parameter of type BSTR outputName [in]
outputName is a parameter of type IDatasetName resultTable [out, retval]
resultTable is a parameter of type ITable

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Description

Dissolve aggregates features of an input layer based on values of a specified attribute; and can be used to create either a new layer or a stand alone summary table.

Remarks

The useSelected state refers to whether or not a selected subset of the InputTable is to be dissolved. True signifies that a selected subset will be dissolved. False signifies that Dissolve will ignore any selected subset and will dissolve the entire set.

The summaryFields argument is a comma-delimited string that lists the generated summary fields. The syntax for the summaryFields argument is <operation_code1>.<field_name1>, <operation_codeN>.<field_nameN>. Operation codes include: Dissolve, Count, Minimum, Maximum, Sum, Average, Variance and StdDev.

To perform a spatial dissolve (i.e. output features instead of a summary table) the Dissolve operation code must be used in conjunction with the shape field at the beginning of the summaryFields string. Example: "Dissolve.Shape, Sum.Area, StdDev.Area, etc..." To create a stand alone summary table simply remove "Dissolve.Shape".

To include the dissolved field in the output, you must add it to the summary fields. For example, if you were disolving on a field called name, set the summary fields to: "Minimum.Name, Sum.Area, etc..." to include the name field in the output.


 

See Also

IBasicGeoprocessor Interface