Syntax
WebGet,<FileToDownload>,<FileOnDisk>[,MD5][,Ask][,Timeout]]
Use this function to download files from a network server to the local machine.
- It is assumed that both machines (local and remote) are prepared for this operation.
- No checks are done to ensure that the local machine is online or that is has enough disk space to download the file.
- The remote server must also be accessible and the file must be available for download.
- Only direct download links are accepted, dynamic internet pages are not valid.
MD5 check is an additional parameter that can be added to ensure that your file matches a security check based on the MD5 hash calculation.
- This is an optional parameter, only needed for cases when it is important to only accept a file that passes on this download integrity test.
- If a file fails this test it won't be copied over to the final destination as FileOnDisk.
The optional parameters of Ask
and Timeout
are only used if enabled
, and if enabled, will display a question dialog box, and wait for a response. This can be used to let the user skip over a download operation.
- To use this feature, the line "Ask before WebGet" in the Winbuilder Tab TOOLS\OPTIONS has to be checked.
- To use optional timeout, the line "Use Timeout when asking" in the Winbuilder Tab TOOLS\OPTIONS has to be checked.
If the target filename folder doesn't exist, it will be created. If a file already exists it will be overwritten (read WebGetIfnotExist
for alternative behavior)
Example:
In this example we download the file iview423.zip from server foo.com to the folder c:\IrfanView\iview423.zip
- only if MD5sum is fd490d07cc236cb44ef29abfd9daf13d
- with a question dialog's text string displaying 'ZIP-file'
- and automatically accept the dialog (i.e. timeout) after 10 seconds
WebGet,http://foo.com/iview423.zip,c:\IrfanView\iview423.zip,fd490d07cc236cb44ef29abfd9daf13d,ZIP-file,10