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
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
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.
See Also
LocatorManager Class | ILocatorManager2 Interface | IAttachedLocator Interface | AttachedLocator Class | ILocatorManager Interface | ILocatorAttach2 Interface | ILocatorAttach2.AttachLocator Method | AttachedLocator Class | IAddressGeocoding.MatchTable Method | IAttachedLocator Interface | ILocatorManager Interface | IAttachedLocator Interface | ILocatorManager2 Interface | AttachedLocator Class | ILocatorManager2 Interface | ILocatorManager Interface | ILocatorManager.HasLocatorAttached Method | AttachedLocator Class | IAttachedLocator Interface | ILocatorManager.GetLocatorFromDataset Method