Using Statement Parameters

A parameter is a variable in an SQL statement that can enable an ODBC application to:

• Efficiently provide values for columns in a table.
• Enhance user interaction in constructing query criteria.
• Manage text, ntext, and image data and Microsoft® SQL Server™-specific C data types.

For example, suppose a parts table has columns named partid, description, and price. To add a part without parameters requires constructing an SQL statement such as:

INSERT INTO Parts (PartID, Description, Price) VALUES (2100, 'Drive shaft', 50.00)

Although this statement is fine for inserting one row with a known set of values, it is unwieldy if an application needs to insert several rows. ODBC addresses this by allowing an application to replace any data value in an SQL statement by a parameter maker, which is denoted by a question mark (?). In the following example, three data values are replaced with parameter markers:

INSERT INTO Parts (PartID, Description, Price) VALUES (?, ?, ?)

The parameter markers are then bound to application variables. To insert a new row, the application has only to set the values of the variables and execute the statement. The driver then retrieves the current values of the variables and sends them to the data source. If the statement will be executed multiple times, the application can make the process even more efficient by preparing the statement.

Each parameter marker is referenced by its ordinal number, assigned to the parameters from left to right. The leftmost parameter marker in an SQL statement has an ordinal value of 1, the next one is ordinal 2, and so on.

To execute a statement directly

To prepare and execute statements