所有值位于内存中时将数据作为表值参数发送 (ODBC)

本主题描述当所有值都在内存中时，如何将数据作为表值参数发送到存储过程。 若要查看演示表值参数的另一个示例，请参阅使用表值参数 (ODBC)。

前提条件

该过程假定已在服务器上执行以下 Transact-SQL：

create type TVParam as table(ProdCode integer, Qty integer)
create procedure TVPOrderEntry(@CustCode varchar(5), @Items TVPParam, 
            @OrdNo integer output, @OrdDate datetime output)
         as 
         set @OrdDate = GETDATE();
         insert into TVPOrd (OrdDate, CustCode) 
values (@OrdDate, @CustCode) output OrdNo); 
         select @OrdNo = SCOPE_IDENTITY(); 
         insert into TVPItem (OrdNo, ProdCode, Qty)
select @OrdNo, @Items.ProdCode, @Items.Qty 
from @Items

发送数据

1. 声明 SQL 参数的变量。 这种情况下，表值全都在内存中，因此将表值的列值声明为数组。

   SQLRETURN r;
   // Variables for SQL parameters.
   #define ITEM_ARRAY_SIZE 20
   
   SQLCHAR CustCode[6];
   SQLCHAR *TVP = (SQLCHAR *) "TVParam";
   SQLINTEGER ProdCode[ITEM_ARRAY_SIZE], Qty[ITEM_ARRAY_SIZE];
   SQLINTEGER OrdNo;
   char OrdDate[23];
   
   // Variables for indicator/length variables associated with parameters.
   SQLLEN cbCustCode, cbTVP, cbProdCode[ITEM_ARRAY_SIZE], cbQty[ITEM_ARRAY_SIZE], cbOrdNo, cbOrdDate;
   

2. 绑定参数。 使用表值参数时，绑定参数是两阶段进程。 在第一阶段，以正常方式绑定存储过程的步骤参数，如下所示。

   // Bind parameters for call to TVPOrderEntryDirect.
   // 1 - Custcode input
   r = SQLBindParameter(hstmt, 1, SQL_PARAM_INPUT,SQL_VARCHAR, SQL_C_CHAR, 5, 0, CustCode, sizeof(CustCode), &cbCustCode);
   
   // 2 - Items TVP
   r = SQLBindParameter(hstmt, 
       2,// ParameterNumber
       SQL_PARAM_INPUT,// InputOutputType
       SQL_C_DEFAULT,// ValueType 
       SQL_SS_TABLE,// Parametertype
       ITEM_ARRAY_SIZE,// ColumnSize: For a table-valued parameter this is the row array size.
       0,// DecimalDigits: For a table-valued parameter this is always 0. 
       TVP,// ParameterValuePtr: For a table-valued parameter this is the type name of the 
   //table-valued parameter, and also a token returned by SQLParamData.
       SQL_NTS,// BufferLength: For a table-valued parameter this is the length of the type name or SQL_NTS.
       &cbTVP);// StrLen_or_IndPtr: For a table-valued parameter this is the number of rows actually used.
   
   // 3 - OrdNo output
   r = SQLBindParameter(hstmt, 3, SQL_PARAM_OUTPUT,SQL_INTEGER, SQL_C_LONG, 0, 0, &OrdNo,
      sizeof(SQLINTEGER), &cbOrdNo);
   // 4 - OrdDate output
   r = SQLBindParameter(hstmt, 4, SQL_PARAM_OUTPUT,SQL_TYPE_TIMESTAMP, SQL_C_CHAR, 23, 3, &OrdDate, 
      sizeof(OrdDate), &cbOrdDate);
   

3. 参数绑定的第二阶段是绑定表值参数的列。 首先将参数焦点设置为表值参数的序号。 然后使用 SQLBindParameter 绑定表值的列，绑定时将按照它们是存储过程的参数时将要采用的相同方式进行，不过是以列序号作为 ParameterNumber。 如果有更多表值参数，我们会轮流将焦点设置为每个参数，并绑定它们的列。 最终，将参数焦点重置为 0。

   // Bind columns for the table-valued parameter (param 2).
   // First set focus on param 2.
   r = SQLSetStmtAttr(hstmt, SQL_SOPT_SS_PARAM_FOCUS, (SQLPOINTER) 2, SQL_IS_INTEGER);
   
   // Col 1 - ProdCode
   r = SQLBindParameter(hstmt, 1, SQL_PARAM_INPUT,SQL_INTEGER, SQL_C_LONG, 0, 0, ProdCode, sizeof(SQLINTEGER), cbProdCode);
   // Col 2 - Qty
   r = SQLBindParameter(hstmt, 2, SQL_PARAM_INPUT,SQL_INTEGER, SQL_C_LONG, 0, 0, Qty, sizeof(SQLINTEGER), cbQty);
   
   // Reset param focus.
   r = SQLSetStmtAttr(hstmt, SQL_SOPT_SS_PARAM_FOCUS, (SQLPOINTER) 0, SQL_IS_INTEGER);
   

4. 填充参数缓冲区。 cbTVP 将设置为要发送到服务器的行数。

   // Populate parameters.
   cbTVP = 0; // Number of rows available for input.
   strcpy_s((char *) CustCode, sizeof(CustCode), "CUST1"); cbCustCode = SQL_NTS;
   
   ProdCode[cbTVP] = 1215;cbProdCode[cbTVP] = sizeof(SQLINTEGER); 
   Qty[cbTVP] = 5;cbQty[cbTVP] = sizeof(SQLINTEGER); 
   cbTVP++; // Number of rows available for input
   
   ProdCode[cbTVP] = 1017;cbProdCode[cbTVP] = sizeof(SQLINTEGER); 
   Qty[cbTVP] = 2;cbQty[cbTVP] = sizeof(SQLINTEGER); 
   cbTVP++; // Number of rows available for input.
   

5. 调用该过程：

   // Call the procedure.
   r = SQLExecDirect(hstmt, (SQLCHAR *) "{call TVPOrderEntry(?, ?, ?, ?)}",SQL_NTS);
   

请参阅

概念

ODBC 表值参数编程示例