ISpatialCacheManager.FillCache Method

Fills the spatial cache using the specified extent.

[Visual Basic .NET]
Public Sub FillCache ( _
    ByVal pExtent As IEnvelope _
)

[C#]
public void FillCache (
    IEnvelope pExtent
);

[C++]
HRESULT FillCache(
  IEnvelope* pExtent
);

[C++]
Parameters
pExtent 
  pExtent is a parameter of type IEnvelope

Product Availability

Remarks

The CacheIsFull property returns true if the cache is full (the cache is active). The FillCache method is used to make the cache active and to set the boundary of the cache. Calling this method causes the workspace to fetch objects from the database and fill the cache. Only features in open feature classes within the cache extent are fetched. Opening a feature class that participates in a topology or geometric network will also open all other feature classes participating in the topology or geometric network.

The time to fill the cache and the amount of memory consumed with the cache depends on the extent of the cache and the density and size of features in the feature classes being cached.

It should be noted that all attributes of a feature within the envelope will be cached when the call is made to FillCache. Also, only those features that are in currently open feature classes will be cached. Therefore if you only want to perform spatial searches against a specific feature class it would make sense to only have that feature class open when the cache is filled. The more feature classes open when FillCache is called the more expensive the fill cache operation is.

See Also