UploadStart (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Web-specific functions / Upload functions

Operating mode of the file upload performed via the Upload control
Limits
Maximum size of files to upload

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

UploadStart (Function)

In french: UploadLance

Starts sending the selected files into an Upload control. At the end of the upload, the list of the files to send is cleared on the browser (no matter whether the control sends one or more files).

Example

// -- Evénement "A chaque modification de la liste des fichiers sélectionnés"
// dans le champ UPL_Upload
// Lance l'envoi du fichier et transmet le contenu du champ SAI_Famille
UploadStart(MySelf, SAI_Famille)

// -- Evénement "Réception des fichiers uploadés"
PROCEDURE Réception(NomFamille)
// Copie le fichier dans le répertoire correspondant à la famille
UploadCopyFile(MySelf, CompleteDir(sRépertoireDestination) + NomFamille, "")

Syntax

UploadStart(<Upload control> [, <Parameter 1> [... [, <Parameter N>]]])

<Upload control>: Control name

Name of the Upload control to be used.

<Parameter 1>: Any type

First parameter that must be passed to the server event "Receive files uploaded". To retrieve this parameter, a procedure in the following format must be declared in the "Receive files uploaded" event:
PROCEDURE ProcedureName(<Parameter 1> [, ... [, <Parameter N>]])
If this function is used in a PHP site, you cannot specify the parameters to pass to the server event "Receive files uploaded". This feature is not supported in PHP.

<Parameter N>: Any type

Nth parameter that must be passed to the server event "Receive files uploaded". To retrieve this parameter, a procedure in the following format must be declared in the "Receive files uploaded" event:
PROCEDURE ProcedureName(<Parameter 1> [, ... [, <Parameter N>]])
If this function is used in a PHP site, you cannot specify the parameters to pass to the server event "Receive files uploaded". This feature is not supported in PHP.

Remarks

Operating mode of the file upload performed via the Upload control

Several events are associated with the Upload control (single or multi-file):

For a single-file Upload control, these events are associated with the "Send" button.
In the case of a multi-file Upload control, these events are associated with the "Add" button.

The events used when uploading the selected files are:

Browser event "Progress of transfer":
This event is called regularly during the upload to update a progress bar, if available.
Server event "Receive files uploaded":
This event is executed when all the files are received by the server.
Remark: If the UploadStart function is called with additional parameters, these parameters are passed on to the "Receive files uploaded" event. To retrieve these parameters, a procedure must be declared in this event (via the PROCEDURE statement).

Limits

Changes made in the server event "Receive files uploaded" are NOT carried over to the browser. These modifications will be visible during the next display of the page.

Maximum size of files to upload

By default, the size of files to upload is not limited in the WEBDEV engine. This size can be limited by the WEBDEV Application Server.
The file will not be uploaded if its size exceeds the limit size.
To modify the maximum size of the files to upload in the WEBDEV Application Server, the registry must be modified on the server:

To change the size of uploaded files for all WEBDEV 2025 applications, select the following key:
- 32-bit: HKEY_LOCAL_MACHINE\SOFTWARE\PC SOFT\WEBDEV\30.0
- 64-bit: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\PC SOFT\WEBDEV\30.0
Add the MAX_UPLOAD string. The value of this string will be the maximum size of files to upload (in KB).

Limits in PHP:

The size of the uploaded files is limited by the "upload_max_filesize" directive in the configuration file of PHP (php.ini file).
The file upload must be allowed by the PHP server. To do so, the "file_uploads" directive must be set to "on" in the configuration file of PHP (php.ini file).
The upload_tmp_dir directive of the configuration file must be specified toward a directory with read/write rights.

Related Examples:

Unit examples (WEBDEV): Uploading or Downloading a file

[ + ] This example explains how to upload (copy to the server) or download (download from the server) a file and it allows you to:
- Copy a file from the browser computer to the server
- Download a file found on the server
- Download a file found on the server via a link
- Download a file found on the server by requesting its opening

Component: WDJS.DLL