Exists Method  
 

Determine if a specific stored object exists in the container.

Syntax

object.Exists( ObjectLabel )

Parameters

ObjectLabel
A string which specifies the label of the object.

Return Value

A value of True is returned if the object exists. Otherwise, a value of False is returned and the LastError property will return the specific cause of the failure.

Remarks

The Exists method is used to check for the existence of a stored object in the current container. If the object exists, various properties that return information about the current object, such as ObjectId and ObjectSize will be updated to return the metadata associated with the object.

Although storage object labels are similar to Windows file names, they are case-sensitive. When requesting information about an object, your application must specify the label name exactly as it was created. The object label cannot contain wildcard characters.

To obtain information about how much storage your applications are using and the total number of stored objects, use the StorageUsed and StorageObjects properties.

If you wish to enumerate all of the stored objects within the container, use the FindFirst and FindNext methods.

See Also

ObjectId Property, ObjectModified Property, ObjectSize Property, StorageObjects Property, StorageUsed Property, FindFirst Method, FindNext Method