Syntax

Parameters

• serverFile �
  A string containing the name of the file on the application�s virtual file path on the Web server.

• open �
  A boolean that determines whether to access the file in open mode or download mode. Values are:
  • true � show the file directly in a browser window (open mode).
  • false � show a dialog box that lets the user open the file, save the file, or cancel the download operation (download mode).

Returns

None.

Examples

• �
  This example opens the file aaa.txt in download mode:
  
  PowerBuilder

  #if defined PBWEBFORM then DownloadFile("c:aaa.txt", false) #end if

  1 2 3

  #if defined PBWEBFORM then      DownloadFile("c:aaa.txt", false)    #end if

  The download mode causes the File Download dialog box to appear, giving the user the choice of opening the file, saving the file, or cancelling the operation. The File Download dialog box shows the file name, the file type, the number of bytes in the file, and the name of the server that hosts the file.

• �
  This code opens a dialog box that allows users to select a directory and download multiple files from the same directory:
  PowerBuilder

  string docpath, docname[] boolean lb_open integer i, li_cnt, li_rtn, li_filenum lb_open = true //or false li_rtn = GetFileOpenName("Select File", docpath, & + docname[], "DOC", & + "Text Files (*.TXT),*.TXT," & + "Doc Files (*.DOC),*.DOC," & + "All Files (*.*), *.*", & "C:Program FilesSybase", 18) IF li_rtn < 1 THEN return li_cnt = Upperbound(docname) // if only one file is picked, docpath contains the // path and file name if li_cnt = 1 then mle_1.text = string(docpath) #if defined PBWEBFORM then DownloadFile(string(docpath), lb_open) #end if else // if multiple files are picked, docpath contains // the path only - concatenate docpath and docname for i=1 to li_cnt string s s = string(docpath) + "" +(string(docname[i])) #if defined PBWEBFORM then DownloadFile(s, lb_open) #end if mle_1.text += s +"~r~n" next end if

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32

  string docpath, docname[]    boolean lb_open    integer i, li_cnt, li_rtn, li_filenum      lb_open = true //or false    li_rtn = GetFileOpenName("Select File",  docpath, &       + docname[], "DOC", &       + "Text Files (*.TXT),*.TXT," &       + "Doc Files (*.DOC),*.DOC," &       + "All Files (*.*), *.*", &       "C:Program FilesSybase", 18)    IF li_rtn < 1 THEN return    li_cnt = Upperbound(docname)    // if only one file is picked, docpath contains the    // path and file name       if li_cnt = 1 then          mle_1.text = string(docpath)          #if defined PBWEBFORM then          DownloadFile(string(docpath), lb_open)       #end if    else       // if multiple files are picked, docpath contains       // the path only - concatenate docpath and docname       for i=1 to li_cnt          string s          s = string(docpath) + "" +(string(docname[i]))          #if defined PBWEBFORM then             DownloadFile(s, lb_open)          #end if          mle_1.text += s +"~r~n"        next     end if

Usage

Some types of files cannot be viewed directly in a browser window. For these types of files, the open argument is disregarded. Instead, the File Download dialog box appears, as if you set the open argument to false, but the dialog box provides no option to open the file directly. In this case, users can only save the file to disk or cancel the download operation.

If the file you indicate in the serverFile argument is not present on the server, application users do not see an error message. You can use the FileExists PowerScript function to make sure the file exists in the server directory before you call DownloadFile.