INFO: ASP.NET Web Configuration Parameters (Legacy Web Controls)


Legacy Controls NOTICE

This article references our legacy Web Forms Web Viewing controls (WebImageViewer, WebAnnotationViewer, WebThumbnailViewer). It is preserved for archival purposes, but support strongly recommends using our modern HTML5 web controls: WebDocumentViewer, WebDocumentThumbnailer instead)

INFO: WebDocumentViewer Whitepaper - Getting Started With Web Viewing

Main Article Content

web.config Parameters

These are the appSetting parameters you can set in your web.config file. Put them in the <appSettings> section of the file.

Setting Description Note
AtalasoftWebControls_Cache Location of the cache relative to the root of the application
AtalasoftWebControls_CacheFilesOnly Set to true if only files should be put in the cache.
Set to false if it is OK to create directories.
Default is true.
Setting this value to false while using .NET 2.0 can cause the application to recompile while files are deleted from the cache. Use the default setting for .NET 2.0.
AtalasoftWebControls_CacheLifeTime

Number of minutes a file can live in the cache without being used.
Default is 20.

Set value to the length of time that a session is allowed to stay alive before it times out.
AtalasoftWebControls_DisableCache Set to true to disable the image cache. The default is "false". Use this option only if you are never going to need to modify images, load them from a direct file path, or you are saving them yourself. This turns off warnings for the Cache, and may render the control unusable. Use at your own risk.
AtalasoftWebControls_ErrorLogging Set to true to enable the error log. The default is false . Log files will be placed in the Cache alongside images and time stamps for the same session. These files are automatically cleaned up when the session is cleaned up.
AtalasoftWebControls_ResourcePath Set the location of Javascript and Image resources required by the control. Before version 4.0, this was a property of the control, but now must be set in the web.config. If it is not set, resources are requested from the control assembly, which is slower.
AtalasoftWebControls_ShowClientErrors

Set to true to show JavaScript errors in the browser.
Set to false otherwise.
The default is true


Example

HTML
<appSettings>
   <add key="AtalasoftWebControls_Cache" value="ImageCache/" />
   <add key="AtalasoftWebControls_CacheLifeTime" value="60" />
   <add key="AtalasoftWebControls_ResourcePath" value="Resources/" />
</appSettings>

Original Article:
Q10353 - INFO: ASP.NET Web Configuration Parameters (Legacy Web Controls)