ILocatorWorkspace.RenameLocator Method

Renames a locator.

[Visual Basic 6.0]
Sub RenameLocator(
    ByVal oldName As String, _
    ByVal newName As String _
)

[Visual Basic .NET]
Public Sub RenameLocator ( _
    ByVal oldName As String, _
    ByVal newName As String _
)

[C#]
public void RenameLocator (
    string oldName,
    string newName
);

[Java]
public void renameLocator (
    String oldName,
    String newName
)
throws
    IOException,
    AutomationException

[C++]
HRESULT RenameLocator(
  BSTR oldName,
  BSTR newName
);

Product Availability

Remarks

The oldName parameter is the current name of the locator or locator style that you want to rename. The newName parameter is the new name for the locator or locator style.

Within the default local locator workspace, and within ArcSDE locator workspaces, locator names are prefixed by a user name, as in "jack.My Locator". In local locator workspaces, the locator name is prefixed by the user name of the current user. In ArcSDE workspaces, the locator name is prefixed by the name of the ArcSDE user that owns the locator. When you call methods in ArcObjects that have parameters that specify locators in a locator workspace, you must specify the full name of the locator, including the user name. Failing to do so will result in an error. 

You must fully-qualify the oldName parameter with a user name. Do not qualify the newName parameter with a user name; the locator workspace will add the user name automatically.

See Also

ILocatorWorkspace Interface | GxLocator Class | LocatorExtension Class | IAddressUI.RematchTable Method | ILocatorWorkspace.GetLocator Method | ILocator Interface | ILocatorWorkspace.UpdateLocator Method | ESRIFDOAddressLocatorStyle Class | StreetMapAddressLocator Class | StreetMapAddressLocatorStyle Class | ESRIFDOAddressLocator Class | GxLocatorFolder Class | GxLocatorFactory Class | IGxLocatorFolder Interface | ILocalLocatorWorkspace Interface | ILocatorManager.GetLocatorWorkspace Method | ILocalLocatorWorkspace.Path Property | IGxNewLocator Interface | ILocatorStyle Interface | ILocatorWorkspace.GetLocatorStyle Method | ESRIFDOAddressLocatorStyle Class | StreetMapAddressLocatorStyle Class

Send feedback on this page