ArcObjects Library Reference (Location)

AttachedLocator Class

A locator that is attached to a dataset.

AttachedLocator is a non-creatable object. References to non-creatable objects must be obtained through other objects.

Product Availability

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

Description

An AttachedLocator describes a locator that is attached to a dataset, along with the names of the input and output fields in the dataset used by the locator.

Supported Platforms

Windows, Solaris, Linux

Extended Error Information

Use the ISupportErrorInfo method InterfaceSupportsErrorInfo to determine if the object supports extended error information. If the object supports extended error info, VC++ developers should use the OLE/COM IErrorInfo interface to access the ErrorInfo object. Visual Basic developers should use the global error object Err to retrieve this extended error information.

Interfaces

Interfaces	Description
IAttachedLocator	Provides access to members that describe the process used to create the feature class.
ISupportErrorInfo	Indicates whether a specific interface can return Automation error objects.

Remarks

When you geocode a table of addresses using a locator in ArcCatalog or in ArcMap, a copy of that locator is "attached" to the geocoded feature class. Use the AttachedLocator object to retrieve a copy of the locator that is attached to a dataset, in order to examine the geocoding settings that were used to create the geocoded feature class, or to rematch the geocoded feature class. Use the ILocatorManager::GetLocatorFromDataset method to retrieve an attached locator from a dataset.

Developers who geocode a table of addresses using IAddressGeocoding::MatchTable must write additional code to attach the locator to the geocoded feature class using the ILocatorAttach2::AttachLocator method.

Only one locator can be attached to a dataset. If you attach a locator to a dataset that already has an attached locator, the original attached locator will be replaced by the new attached locator.