IWorkspaceFactorySchemaCache Interface

Manages Geodatabase workspace schema caches.

Description

The schema cache is a cached snapshot of the geodatabase system tables (often referred to as the geodatabase schema). In an enterprise environment the geodatabase system tables (geodatabase schema) are in constant use by ArcGIS. Caching this schema locally can reduce database roundtrips by using the locally cached representation of the geodatabase schema.

Members

	Name	Description
	DisableAllSchemaCaches	Disable the schema caches of all open workspaces.
	DisableSchemaCache	Disable the schema cache for a specific workspace.
	DisableSchemaCaching	All new workspaces handed out by the factory will not have schema caching enabled.
	EnableAllSchemaCaches	Enable the schema caches of all open workspaces.
	EnableSchemaCache	Enable the schema cache for a specific workspace.
	EnableSchemaCaching	All new workspaces handed out by the factory will have schema caching enabled.
	IsAnySchemaCacheStale	Checks all current schema caches for staleness.
	IsSchemaCacheStale	Checks a specific schema cache for staleness.
	RefreshAllSchemaCaches	Refreshes all current schema caches.
	RefreshSchemaCache	Refreshes the schema cache for a specific workspace.

IWorkspaceFactorySchemaCache.DisableAllSchemaCaches Method

Disable the schema caches of all open workspaces.

Public Sub DisableAllSchemaCaches ( _
)

public void DisableAllSchemaCaches (
);

IWorkspaceFactorySchemaCache.DisableSchemaCache Method

Disable the schema cache for a specific workspace.

Public Sub DisableSchemaCache ( _
    ByVal Workspace As IWorkspace _
)

public void DisableSchemaCache (
    IWorkspace Workspace
);

IWorkspaceFactorySchemaCache.DisableSchemaCaching Method

All new workspaces handed out by the factory will not have schema caching enabled.

Public Sub DisableSchemaCaching ( _
)

public void DisableSchemaCaching (
);

Description

This method disables schema caching on the workspace factory.

IWorkspaceFactorySchemaCache.EnableAllSchemaCaches Method

Enable the schema caches of all open workspaces.

Public Sub EnableAllSchemaCaches ( _
)

public void EnableAllSchemaCaches (
);

IWorkspaceFactorySchemaCache.EnableSchemaCache Method

Enable the schema cache for a specific workspace.

Public Sub EnableSchemaCache ( _
    ByVal Workspace As IWorkspace _
)

public void EnableSchemaCache (
    IWorkspace Workspace
);

Description

The EnableSchemaCache method will enable the schema cache for one workspace.

IWorkspaceFactorySchemaCache.EnableSchemaCaching Method

All new workspaces handed out by the factory will have schema caching enabled.

Public Sub EnableSchemaCaching ( _
)

public void EnableSchemaCaching (
);

Description

This method will enable chaching on any IWorkspace passed out by the workspace factory.

IWorkspaceFactorySchemaCache.IsAnySchemaCacheStale Method

Checks all current schema caches for staleness.

Public Function IsAnySchemaCacheStale ( _
) As Boolean

public bool IsAnySchemaCacheStale (
);

IWorkspaceFactorySchemaCache.IsSchemaCacheStale Method

Checks a specific schema cache for staleness.

Public Function IsSchemaCacheStale ( _
    ByVal Workspace As IWorkspace _
) As Boolean

public bool IsSchemaCacheStale (
    IWorkspace Workspace
);

IWorkspaceFactorySchemaCache.RefreshAllSchemaCaches Method

Refreshes all current schema caches.

Public Sub RefreshAllSchemaCaches ( _
)

public void RefreshAllSchemaCaches (
);

IWorkspaceFactorySchemaCache.RefreshSchemaCache Method

Refreshes the schema cache for a specific workspace.

Public Sub RefreshSchemaCache ( _
    ByVal Workspace As IWorkspace _
)

public void RefreshSchemaCache (
    IWorkspace Workspace
);

Classes that implement IWorkspaceFactorySchemaCache

Classes	Description
SdeWorkspaceFactory (esriDataSourcesGDB)	Esri SDE Workspace Factory.

Remarks

It is most common to use the schema cache when the geodatabase schema is in heavy use. In ArcGIS this is most common when opening a large number of datasets. For instance internally, ArcGIS uses the schema cache when opening all the layers in a map document. The schema cache is most beneficial when working with large static data models where geodatabase objects like tables, fields, domains and relationships are well defined and do not change.

To get the greatest benefit from the schema cache the cache should be filled prior to opening any datasets. Once filled any calls to Open methods including IName.Open will be satisfied by the active schema cache and therefore optimized.