<dextupload.net><settings> Settings
The "settings" element of the "dextupload.net" section in the "Web.config" file contains environmental values for handling file upload.
It must be able to recognize the "dextupload.net" section by declaring the "sectionGroup" element of the "configSections".
<?xml version="1.0"?> <configuration> <configSections> <!-- Defines a section for reading dextupload.net configuration. --> <sectionGroup name="dextupload.net"> <section name="settings" ... /> </sectionGroup> </configSections> <!-- DEXTUpload.NET Professional configuration section --> <dextupload.net> <settings tempPath="~/files/temp" defaultPath="~/files/store" uploadTimeout="3600" maxFileLength="10485760" maxTotalLength="20971520" whiteExtensions="txt,jpg,png,gif,docx,xlsx,pptx,hwp,pdf,zip" availableNoFileExtension="true" filterAction="error" encoding="65001" compact="false" cleanerIntervalTime="60000" timeAgoForCleaning="24" enableCleaner="false" signatureDataFilePath="" methodFileSignatureChecking="noChecking" authkey="9Ubwly9EZZZhBENEep ... skip ... JyGxAJcB03gQQcM1Q"/> </dextupload.net> </configuration>
Information about the attributes of the "settings" elements are as follows.
tempPath |
Sets the path where the temporary file is generated. Starting with "~" means the paths relative to the root of the Web application, set the path which is a local path containing drive letter(C:\, D:\) or the UNC(\\) path. |
---|---|
defaultPath |
Sets the default path where the files are stored. Starting with "~" means the paths relative to the root of the Web application, set the path which is a local path containing drive letter(C:\, D:\) or the UNC(\\) path. By default, it is the same to the "tempPath". |
uploadTimeout |
Sets the time limit of the request(in seconds). It is only applied this attribute to requests passed through the DEXTUpload.NET Professional component. The default is 3600 seconds. In the debug environment, there is no effect. |
maxFileLength |
Sets the maximum allowable size(byte unit) of individual files. The default value is -1, it does not limit the size of the file. Restriction of maximum allowable size, the limit value of the IIS itself is priority to the value of the "maxFileLength". And the "maxFileLength" means the size of file not size of request. |
maxTotalLength |
Sets the maximum allowable total file size(byte unit). The default value is -1, it does not limit the size of the file. Restriction of maximum allowable size, the limit value of the IIS itself is priority to the value of the "maxTotalLength". And the "maxTotalLength" means the sum size of files not the request. The "maxTotalLength" is ignored in large(more than 2GB) file upload environment. |
whiteExtensions |
Sets a list of file extensions that upload is allowed. It is separated by comma(,). By default it does not limit file extension. |
availableNoFileExtension |
Allow upload of files without extension. The default value is true. |
filterAction |
Sets the way to handle filtered files by size and extension limit. "Error": it ocurres exception. "Flushing": the filtered file is saved as a file of 0 bytes. By default, the "error". |
encoding |
Sets the character set used in processing string data in the internal components. The default is "utf-8". |
compact |
If the size of the file is 0 or empty, it is possible to completely remove the field of the form. By default, it is "false". |
cleanerIntervalTime |
Sets the time interval of cleaner events for deletion job. Unit is milliseconds(1/1000), it cannot be specified under 1 minute, it must be specified smaller than or equal to "Int32.MaxValue". The default value is 60000ms(1 minute). |
timeAgoForCleaning |
The temporary files created ago this time(hour) is going to be removed by cleaner. Unit is hour, it must be specified greater than 1 and lower than or equal to "Int32.MaxValue". The default is 24. |
enableCleaner |
Sets whether cleaner regularly deletes the temporary files. If you set the "enableCleaner" attribute to "true", the cleaner is internally started when the first file upload. Cleaner is ready to delete the files in the temporary folder based on the specified value at the "cleanerIntervalTime, timeAgoForCleaning" attributes or default values. For example, if the value of "cleanerIntervalTime" is 60000 and the value of "timeAgoForCleaning" is 24, cleaner deletes all files past 24 hours in the temporary folder pointed to "tempPath" attribute every minute. In the case of uploading of large files, if some temporary files exist, it is possible to re-upload files continually even after a few days. However, if cleaner is working, the files past the specified time of the "timeAgoForCleaning" attribute will be deleted all. When the "Dispose" method of the "DEXTUpload.NET.FileUpload" object is called, the temporary files will be deleted. the cleaner is used to delete which remained still or the junk files occured during uploading of large files. In addition, the cleaner deletes the files remained by using the "Keep" method of "DEXTUpload.NET.FileElement" class. When sharing the same temporary folder of many web applications, in the course of multiple processes to remove the temporary files may be made I/O errors. By default, it is "false". |
signatureDataFilePath (support from 5.2.0.0 version) |
Sets the path of the signature resource file that are required to the signature inspection. As signature resource file is needed to run the signature checking, the basic resource file is included in the product itself, but if the path to the "signatureDataFilePath" attribute is set, it will make a signature test using a file of the given path as a resource. By default, is "null". |
methodFileSignatureChecking (support from 5.2.0.0 version) |
Sets the method of inspecting a signature. If the attribute is not set, the default value is "noChecking", not running the signature check. For more information, see the "File signature inspection". |
authkey |
Sets the issued authentication key. |
It may be omitted altogether other attributes except "authkey, tempPath".
<?xml version="1.0"?> <configuration> <configSections> <sectionGroup name="dextupload.net"> <section name="settings" ... /> </sectionGroup> </configSections> <dextupload.net> <settings tempPath="~/files/temp" authkey="9Ubwly9EZZZhBENEep ... JyGxAJcB03gQQcM1Q"/> </dextupload.net> </configuration>