Readme_Table-Valued Parameters (ODBC)
This sample depends on features that were introduced in SQL Server 2008. It will not work with any version of SQL Server earlier than SQL Server 2008.
This sample shows how to use table-valued parameters to insert multiple rows, with multiple columns, with one call to the server.
SQL Server samples and sample databases must be downloaded and installed before you can view or work with them. For more information, see Considerations for Installing SQL Server Samples and Sample Databases.
Scenario
For more information on this sample, see Table-Valued Parameters (SQL Server Native Client) in Books Online.
Languages
This sample uses Visual C++.
Prerequisites
Before running this sample, make sure the following software is installed:
- SQL Server or SQL Server Express including Database Engine.
You can download SQL Server Express from the Microsoft Download Center. - The AdventureWorks database that is available at the Microsoft SQL Server Developer Center.
- The SQL Server Database Engine samples that are available at the Microsoft SQL Server Developer Center.
- .NET Framework SDK 2.0 (or later) or Microsoft Visual Studio 2005 (or later). You can obtain .NET Framework SDK free of charge. See Installing the .NET Framework Documentation.
- You will also need an ODBC data source called TVPDemo. This data source must be based on the ODBC driver for SQL Server Native Client. The default database for TVPDemo can be any test database on your computer. If you will build and run this sample as a 32-bit application on a 64-bit operating system, you must create the ODBC data source with the ODBC Administrator in %windir%\SysWOW64\odbcad32.exe.
Building the Sample
This sample connects to your computer's default SQL Server instance. To connect to a named instance, change the definition of the ODBC data source to specify the instance using the following format: server\named_instance. By default, SQL Server Express installs to a named instance.
If you are using Visual Studio, load the TableValuedParameters_ODBC.sln file and build it.
If you are using MSBuild.exe, invoke MSBuild.exe in a Command Prompt, passing it the ProcessODBCErrors.sln file:
MSBuild TableValuedParameters_ODBC.sln
Running the Sample
- From Visual Studio, invoke Start Without Debugging (CTRL+F5).
- If you built with MSBuild.exe, invoke TableValuedParameters_ODBC.exe.