FormsRoot Property (RenderingApplication Object)

The FormsRoot property returns or sets the absolute path to a forms directory tree on Microsoft® Internet Information Server (IIS). Read/write.

Syntax

objRendApp.FormsRoot

Data Type

String

Remarks

The FormsRoot property contains the complete path to an IIS disk directory used as the root of a tree of subdirectories containing .ASP files. Each of these subdirectories corresponds to a message class which can be rendered into HTML hypertext. The tree is considered to have its root at a path node ending with the string "\Forms". If the path specified in FormsRoot does not end with this string, it is appended to FormsRoot to access the tree.

Setting the FormsRoot property causes the rendering application to generate a special-purpose format with the name "classpath". This format contains a pattern for each subdirectory in the tree that contains at least one .ASP file. The %classpath% format is used to process the output of the %classpath% substitution token when it appears in the RenderUsing property of a Pattern object.

Note that the the FormsRoot property contains an absolute disk directory path at IIS, while the VirtualRoot property contains an HTTP path at the browser. FormsRoot must be set to a full physical disk directory path, not a URL or a URL fragment. A path using UNC is acceptable for FormsRoot.

If the FormsRoot property has not been set, the %classpath% format is not defined, and the output of the %classpath% substitution token in the pattern's RenderUsing property is used without modification. You must set FormsRoot to the appropriate path if %classpath% is to be used to access a disk directory.

Example

Assuming the following IIS disk directory structure:

  C:\exchsvr\webdata\usa\forms
      \ipm
        \note\*.asp
        \post\*.asp
        \document\*.asp
      \report
        \dr [with no .ASP files]
        \ndr\*.asp
        \ipnrn\*.asp

the %classpath% format is generated to contain the following patterns:

Value property RenderUsing property
* ipm/note/
ipm.post* ipm/post/
ipm.document* ipm/document/
report.ndr* report/ndr/
report.ipnrn* report/ipnrn/