SQLExecWDR (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Running the query
Retrieving the query result

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SQLExecWDR (Function)

In french: SQLExecWDR

Runs the SQL code of a query created in the query editor.

Caution: SQLExecWDR does not start the process for retrieving the result in memory. The result is retrieved during the first call to one of the following functions: SQLFirst, SQLTable or SQLFetch.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// Run the query and retrieve the result line by line
i is int = 0
SQLExecWDR("QueryCustomer84")
WHILE SQLFetch("QueryCustomer84") = 0// There is still another line to read
i++
// Retrieve the data
NAME[i] = SQLGetCol("QueryCustomer84", 1)
FIRSTNAME[i] = SQLGetCol("QueryCustomer84", 2)
EXTENSION[i] = SQLGetCol("QueryCustomer84", 3)
{"IMAGE"+i} = SQLGetMemo("QueryCustomer84", 4)
END
SQLClose("QueryCustomer84")

Syntax

<Result> = SQLExecWDR(<Name of WDR Query> [, <Parameter 1> [... [, <Parameter N>]]])

<Result>: Boolean

True if the query was executed,
False otherwise. If the query was not run, the error message can be returned by the SQL.MesError variable once SQLInfo has been run.

<Name of WDR Query>: Character string (with or without quotes)

Name of query to run. This query was created in the query editor. This name corresponds to the logical query name.
The query name must be enclosed in quotes.

<Parameter 1>: Type of parameter, optional

Value of first query parameter. Each parameter must correspond to the expected type. The different parameters are separated by a comma.

<Parameter N>: Type of parameter, optional

Value of Nth query parameter. The parameters must be specified in their initialization order (visible in the query editor). Each parameter must correspond to the expected type. The different parameters are separated by a comma.

Remarks

Running the query

The information regarding the query execution is returned by SQLInfo. The SQL.NbCol variable contains the number of columns found in the query result.

Once it was run and processed, the query must be freed by SQLClose.

Retrieving the query result

Then, the query result can be:

Transferred into a table or into a list box (SQLTable).
Transferred into controls or variables (SQLAssociate).
Retrieved line by line (SQLFetch).

Component: wd260hf.dll