This method returns a string that describes the estimated time it will take for a visitor to download a particular file from your web server, based on the size of the file and their detected connection speed.
Examples of this string output include: "< 1 minute", "1 minute", "3 minutes", "1 hour, 17 minutes", "2 hours, 11 minutes", and "> 1 day".
Syntax:
numSec = bhObject.EstDownloadTimeSec fullPathToDownloadFile
fullPathToDownloadFile: A string representing the full path and file name of the file you wish to estimate the download time for. For example: "c:\inetpub\wwwroot\downloads\file1.zip".
Example:
<% set bhObj = Server.CreateObject("cyScape.browserObj")
bhObj.SetExtProperties "ConnectionSpeed"
bhObj.GetExtPropertiesEx
%>
<html> Estimated time to download myfile.zip is:
<% timeDesc = bhObh.EstDownloadTimeDesc "c:\inetpub\wwwroot\downloads\myfile.zip"
response.write timeDesc %>
</html>
Note: You must call use SetExtProperties and GetExtPropertiesEx to test the connection speed prior to calling this method.
Note: A return value of N/A indicates that the connection speed test returned a value of 0, and therefore the download time cannot be determined. See the ConnectionSpeed property for information on why it may return 0.
Note: This method requires the Enterprise Edition of BrowserHawk.
See Also: