Getting started

Setting up projects

If you are a developer, install HTMLCaptcha to your development workstation. When you create a new web project, simply add a reference to the HTMLCaptcha.dll file that lives in the installation directory. The necessary libraries will automatically be copied to the project, even on a remote web server.

HTMLCaptcha installs to the GAC, so you can also create projects without copying the files. This is useful when developing software that will run on web hosting providers, or remote web servers, and you don't want to have multiple copies of HTMLCaptcha.dll on the file system. In this scenario, you must install HTMLCaptcha to the web server as well as the development workstation.

HTML image cache

HTMLCaptcha comes with a default set of image data, which is located in the installation directory. This data will need to live somewhere on the web server's hard drive, where it is not accessible via a web URL. It should always be kept private; e.g. don't install it into the wwwroot directory structure where someone could download and analyze it.

The image data consists of two files, htcap.dat and htcap.szb. Copy them from the installation directory to a directory on your webserver, and when you instantiate the HtmlCaptcha object in your project, you must point to this location. (See "Using HTMLCaptcha" for details.) This provides the flexibility of having multiple sets of image data, at various locations.