ILocatorWorkspace.RenameLocator Method

Renames a locator.

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

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

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

[C++]
Parameters
oldName [in]
  oldName is a parameter of type BSTR
newName [in]
  newName is a parameter of type BSTR

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.

In ArcSDE workspaces, locator names are prefixed by the name of the ArcSDE user that owns the locator, as in "jack.My Locator".  When you call methods in ArcObjects that have parameters that specify locators in a ArcSDE 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 | ILocatorWorkspace.GetLocator Method | ILocatorWorkspace.UpdateLocator Method | ILocator Interface | ESRIFDOAddressLocator Class | StreetMapAddressLocator Class | StreetMapAddressLocatorStyle Class | ESRIFDOAddressLocatorStyle Class | LocatorExtension Class | GxLocator Class | ILocalLocatorWorkspace Interface | ILocalLocatorWorkspace.Path Property | ILocatorManager.GetLocatorWorkspace Method | GxLocatorFactory Class | ILocatorWorkspace.GetLocatorStyle Method | ILocatorStyle Interface | StreetMapAddressLocatorStyle Class | ESRIFDOAddressLocatorStyle Class