Uso de parâmetros de instrução

Um parâmetro é uma variável em uma instrução SQL que pode habilitar um aplicativo ODBC para:

• Forneça valores com eficiência para colunas em uma tabela.

• Aprimore a interação do usuário na criação de critérios de consulta.

• Gerenciar dados de texto, ntext e imagem e tipos de dados C específicos do SQL Server.

Por exemplo, uma tabela Parts tem colunas chamadas PartID, Description e Price. Para adicionar uma parte sem parâmetros, é necessário construir uma instrução SQL, como:

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

Embora essa instrução seja aceitável para inserir uma linha com um conjunto conhecido de valores, é estranho quando um aplicativo é necessário para inserir várias linhas. O ODBC resolve isso permitindo que um aplicativo substitua qualquer valor de dados em uma instrução SQL por um criador de parâmetros. Isso é indicado por um ponto de interrogação (?). No exemplo a seguir, três valores de dados são substituídos por marcadores de parâmetro:

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

Os marcadores de parâmetro são associados a variáveis de aplicativo. Para inserir uma nova linha, o aplicativo só precisa definir os valores das variáveis e executar a instrução. Em seguida, o driver recupera os valores atuais das variáveis e os envia para a fonte de dados. Se a instrução for executada várias vezes, o aplicativo poderá tornar o processo ainda mais eficiente preparando a instrução.

Cada marcador de parâmetro é referenciado por seu número ordinal atribuído aos parâmetros da esquerda para a direita. O marcador de parâmetro mais à esquerda em uma instrução SQL tem um valor ordinal de 1; o próximo é ordinal 2, e assim por diante.

Nesta seção

• Parâmetros de associação

Consulte Também

Executando consultas (ODBC)