IBatchGeocoding.RematchTable Method

Rematches a geocoded feature class or shapefile.

[Visual Basic .NET]
Public Sub RematchTable ( _
    ByVal pInputTable As ITable, _
    ByVal inputFieldNames As String, _
    ByVal InputJoinFieldName As String, _
    ByVal resultTable As IFeatureClass, _
    ByVal outputFieldNames As String, _
    ByVal OutputJoinFieldName As String, _
    ByVal whereClause As String, _
    ByVal cancelTracker As ITrackCancel _
)

[C#]
public void RematchTable (
    ITable pInputTable,
    string inputFieldNames,
    string InputJoinFieldName,
    IFeatureClass resultTable,
    string outputFieldNames,
    string OutputJoinFieldName,
    string whereClause,
    ITrackCancel cancelTracker
);

[C++]
HRESULT RematchTable(
  ITable* pInputTable,
  BSTR inputFieldNames,
  BSTR InputJoinFieldName,
  IFeatureClass* resultTable,
  BSTR outputFieldNames,
  BSTR OutputJoinFieldName,
  BSTR whereClause,
  ITrackCancel* cancelTracker
);

[C++]
Parameters
pInputTable [in]
  pInputTable is a parameter of type ITable
inputFieldNames [in]
  inputFieldNames is a parameter of type BSTR
InputJoinFieldName [in]
  InputJoinFieldName is a parameter of type BSTR
resultTable [in]
  resultTable is a parameter of type IFeatureClass
outputFieldNames [in]
  outputFieldNames is a parameter of type BSTR
OutputJoinFieldName [in]
  OutputJoinFieldName is a parameter of type BSTR
whereClause [in]
  whereClause is a parameter of type BSTR
cancelTracker [in]
  cancelTracker is a parameter of type ITrackCancel

Product Availability

Description

The RematchTable method rematches a geocoded feature class or shapefile. In general, you will use the RematchTable method on a locator that you retreived from an AttachedLocator on a geocoded feature class. You can get most of the parameters required by this function from the AttachedLocator.

The pInputTable parameter is a reference to the table that contains the address information, which is usually the geocoded feature class.

The pInputFieldNames parameter is a comma-delimited string containing the names of the fields in pInputTable that contain the address information. Usually, these fields are copied from the original address table to the geocoded feature class when the geocoded feature class is first created, and are prefixed with "ARC_". The field names in the string must be given in the same order as specified by the IAddressInputs::AddressFields property.

The InputJoinFieldName parameter is the name of the field in pInputTable that relates records in this table to records in resultTable. Usually, this parameter is not used because pInputTable and resultTable refer to the same feature class.

The resultTable parameter is the feature class that contains the geocoded addresses.

The outputFieldNames parameter is a comma-delimited string containing the names of the fields in resultTable that contain match information. You can use the IAddressGeocoding::MatchFields property to determine which fields contain the match information. The field names in the string must be given in the same order as specified by the IAddressGeocoding::MatchFields property.

The OuputJoinFieldName parameter is the name of the field in resultTable that relates records in this feature class to records in pInputTable. Usually, this parameter is not used because pInputTable and resultTable refer to the same feature class.

The  WhereClause parameter is a string that contains a SQL clause specifying which records in pInputTable to rematch. To rematch all of the records, specify a blank string for this parameter.

The  CancelTracker parameter is an optional parameter that you can use to specify a CancelTracker to display the progress of the rematch operation.

See Also