File Search and File Property API Classes

Category:
Files and Directories
Type:
Classes
Difficulty:
Advanced
Author:
The Frog Prince

Version Compatibility: Visual Basic 6, Visual Basic 5

More information:
For a screen shot, see http://members.tripod.com/the__frog__prince/Graphics/ssFileSearchAndProperties.jpg

I use these two classes to encapsulate a whole host of file oriented API calls... allowing me to treat files as objects in my code and with the speed that is gained by going through the API.

The clsFile class wraps around a single file, and exposes many properties of a file (and the volume it is on) including: 16 bit equivalent path, parsed filename, size, attributes (readonly, system, archive, etc), dates (created, accessed, and modified) and volume properties: label, serial no., is a cdrom, fixed disk, remote, network path, unc info, etc. (see the screen shot for the full list). Besides being a read only property class, I have modified the .Attributes enum and the .DateLastModified properties to allow changes... so that when you change the properties on the class, the corresponding properties on the file are modified. Eventually, this class could also be modified to extend functions such as Rename, Delete, Copy and Move that would work through the Windows Shell. I have the code to do this, but never bothered patching it in since in my coding, I never ran into the situation where I needed to do these actions with the file object by itself.

The colFiles class acts as a collection for the clsFile class. In addition to the methods you would expect from a collection, this class also encapsulates the API functions for file searching (including recursive directory searches). If you ever intend to use a file search in your applications, going through the API is the only way to achieve this in my opinion. You'll find many examples that try to use directory list boxes to perform file scans, but these examples will be painfully slow. The API, on the other hand, is extremely fast. As fast as the built in Find/Search screen in Windows Explorer. Plus... you are able to search through paths other than your mapped drives. This covers the entire Windows Explorer directory tree (network drives, namespace extensions, etc). Don't judge this class by the screen shots before knowing that in the screen shot example, I was searching across my network which consists of a slow 10Mb hub. You'll have to try it for yourself on your set up to see why I swear by these two classes when performing seek and file property operations.

For updates to this or other useful VB stuff, visit my page: http://members.tripod.com/the__frog__prince/


Instructions: Click the link below to download the code. Select 'Save' from the IE popup dialog. Once downloaded, open the .zip file from your local drive using WinZip or a comparable program to view the contents.

Download fileclasses.zip