com.esri.arcgis.geodatabase
Interface IScratchWorkspaceFactory2

All Superinterfaces:

IScratchWorkspaceFactory, Serializable

All Known Implementing Classes:

FileGDBScratchWorkspaceFactory, ScratchWorkspaceFactory

public interface IScratchWorkspaceFactory2
extends IScratchWorkspaceFactory, Serializable

Provides access to members to get the current scratch workspace.

Description

IScratchWorkspaceFactory is used to create temporary personal geodatabases in the temp directory. You can find this directory by looking at the %TEMP% environment variable. The scratch personal geodatabase will have the name mx<number>.mdb where <number> is the lowest positive number that uniquely identifies the geodatabase.

ScratchWorkspaces are most commonly used for passing in to ITable.Select or IFeatureClass.Select, but can be used anytime a personal geodatabase is required and you want it to automatically be deleted when it's no longer referenced.

The first time IScratchWorkspaceFactory.DefaultScratchWorkspace is called, it will create a new temporary workspace and pass it back. Subsequent calls to this method will return the same workspace. When the application is closed, the default scratch workspace will be deleted.

Workspaces created by IScratchWorkspaceFactory.CreateNewScratchWorkspace will be automatically deleted when the last reference to them is released.

IScratchWorkspaceFactory.CurrentScratchWorkspace will return NULL if the default scratch workspace has not been created yet. Otherwise it will return the default scratch workspace.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Method Summary

IWorkspace

getCurrentScratchWorkspace() The current scratch workspace.

Methods inherited from interface com.esri.arcgis.geodatabase.IScratchWorkspaceFactory

createNewScratchWorkspace, getDefaultScratchWorkspace

Method Detail

getCurrentScratchWorkspace

IWorkspace getCurrentScratchWorkspace()
                                      throws IOException,
                                             AutomationException

The current scratch workspace.

Remarks

IScratchWorkspaceFactory.CurrentScratchWorkspace will return NULL if the default scratch workspace has not been created yet. Otherwise it will return the default scratch workspace.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

A reference to a com.esri.arcgis.geodatabase.IWorkspace

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.