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

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