Provides access to members that supply workspace name information. Note: the IWorkspaceName interface has been superseded byIWorkspaceName2. Please consider using the more recent version.
Product Availability
When To Use
Members
Description | ||
---|---|---|
BrowseName | The browse name of the WorkspaceName. | |
Category | The category of the WorkspaceName. | |
ConnectionProperties | The connection properties of the WorkspaceName. | |
PathName | The path name of the WorkspaceName. | |
Type | The type of the associated workspace. | |
WorkspaceFactory | The workspace factory of the WorkspaceName. | |
WorkspaceFactoryProgID | The ProgID of the WorkspaceName's workspace factory. |
CoClasses that implement IWorkspaceName
CoClasses and Classes | Description |
---|---|
WorkspaceName | ESRI WorkspaceName object. |
Remarks
The IWorkspaceName interface lets you access the properties of a workspace name. To work with a workspace name, you must first set the WorkspaceFactoryProgID property and either the PathName or ConnectionProperties property.
The workspace name can refer to an existing workspace, or one that has yet to be created. If the workspace already exists, it can be opened with IName::Open--effectively this procedure is equivalent to opening a workspace using Open or OpenFromFile on IWorkspaceFactory. If the workspace does not exist and is to be created, use IWorkspaceFactory::Create.
In some circumstances, you may already have a full workspace object but require a workspace name instead. You can retrieve the workspace name from a workspace by calling calling IDataset::FullName on the workspace.
The Type, Category, WorkspaceFactoryProgID, and BrowseName properties all return information on the workspace; refer to the documentation on IWorkspace.
//e.g., workspacePath = "D:\data\geodatabases\Usa.mdb"
public void IWorkspace__get_WorkspaceName(string workspacePath, IWorkspace workspace)
{
//Creates a new workspace name for a personal geodatabase.
IWorkspaceName workspaceName = new WorkspaceNameClass();
workspaceName.WorkspaceFactoryProgID = "esriDataSourcesGDB.AccessWorkspaceFactory";
workspaceName.PathName = workspacePath;
//Or Get a workspace name from an existing workspace.
IDataset dataset = (IDataset)workspace; //Workspaces implement IDataset
workspaceName = (IWorkspaceName)dataset.FullName;
}
See Also
IName Interface | IWorkspaceName Interface