FormsRoot Property (RenderingApplication Object)
FormsRoot Property (RenderingApplication Object)
Important The Collaboration Data Objects (CDO) 1.2.1 Rendering objects are not installed by or supported for use with Exchange Server 2003 or later.
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.
The MAPI property PR_MESSAGE_CLASS, which CDO uses to render the %classpath% token, can contain characters that are illegal in file names and URLs, namely blanks, double quotes, and any of the characters in the string "<>[]\*:;'/|?@=&%#". If CDO encounters any such character when rendering %classpath%, it converts it to an underscore followed by a two-character string representing the hexadecimal value of the original character. This is particularly important when CDO is rendering forms.
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/ |