Inserindo linhas com SQLBulkOperations

A inserção de dados com SQLBulkOperations é semelhante à atualização de dados com SQLBulkOperations porque usa dados dos buffers de aplicativo associados.

Para que cada coluna na nova linha tenha um valor, todas as colunas associadas com um valor de comprimento/indicador de SQL_COLUMN_IGNORE e todas as colunas não associadas devem aceitar valores NULL ou ter um padrão.

Para inserir linhas com SQLBulkOperations, o aplicativo faz o seguinte:

1. Define o atributo de instrução SQL_ATTR_ROW_ARRAY_SIZE como o número de linhas a serem inseridas e coloca os novos valores de dados nos buffers de aplicativo associados. Para obter informações sobre como enviar dados longos com SQLBulkOperations, consulte Long Data e SQLSetPos e SQLBulkOperations.

2. Define o valor no buffer de comprimento/indicador de cada coluna conforme necessário. Esse é o comprimento de byte dos dados ou SQL_NTS para colunas associadas a buffers de cadeia de caracteres, o comprimento de bytes dos dados para colunas associadas a buffers binários e SQL_NULL_DATA para que todas as colunas sejam definidas como NULL. O aplicativo define o valor no buffer de comprimento/indicador dessas colunas que devem ser definidas como padrão (se houver) ou NULL (se não existir) como SQL_COLUMN_IGNORE.

3. Chama SQLBulkOperations com o argumento Operation definido como SQL_ADD.

Após o retorno do SQLBulkOperations , a linha atual permanece inalterada. Se a coluna de marcador de posição (coluna 0) estiver vinculada, SQLBulkOperations retornará os marcadores de posição das linhas inseridas no buffer do conjunto de resultados vinculado a essa coluna.