WebPageFileUpload Function


Posts the content of a Web form, including specified files, to the Web server by means of the HTTP POST method. This function implements a RFC1867-compliant file upload function for form-based file upload in HTML.

This is a mapping to WebPagePost, and uses a form specified in the dclform section to construct the data to post to the server.

The form consists of name-value pairs as usual, only the files to upload need a minor modification: a file to upload needs to be specified by a name-value pair in the following way:

"filename" := "<name of the input tag>;<file name>;<content type>";


Upload of file c:\test.txt

HTML code:

<form enctype="multipart/form-data"
action="data2html.asp" method=post>
  <input type="text" name="anyname" value="anyvalue">
  <input size="32" name="my_file" type="file">
  <input type="submit" value="Upload">

BDL form:

"anyname"  := "anyvalue", "filename" := "my_file;C:\\test.txt;plain/text";

Include file



WebPageFileUpload( in sUrl     : string,
                   in formBody : form,
                   in sTimer   : string optional,
                   in formUrl  : form optional ) : boolean;

Return value

  • true if successful

  • false otherwise

Parameter Description
sUrl Complete URL to the file on the server.
formBody Form identifier used in the dclform section (see example below). The expanded form is added to the body of the request. The Content-Length is added automatically. The Content-Type is multipart/form-data.
sTimer Name of the timer used for page measurements (optional). If this parameter is omitted, no measurements are performed.
formUrl Form identifier used in the dclform section (optional). The expanded form is added to the URL after the "?".


  transaction TWebPageFileUpload
  end TWebPageFileUpload;

    "anyname"  := "anyvalue",
    "filename" := "my_file;"