Como: configurar Parameters for dados Adapters
Na maioria das circunstâncias, objetos Command de um adaptador de dados (SelectCommand, InsertCommand, UpdateCommand e DeleteCommand) referenciam instruções SQL ou procedimentos armazenados que exigem parâmetros.Se você tiver usado o Assistente de Configuração do adaptador de dados para criar o adaptador, então os parâmetros para esses comandos são configurados para você automaticamente.No entanto, você pode querer configurar parâmetros manualmente ou fazer pequenas alterações a uma coleção de parâmetros existente.
.gif "Observação") Observação: |
|---|
Na versão anterior do Visual Studio, adaptadores de dados eram usados para comunicação entre um aplicativo e um banco de dados. Enquanto adaptadores de dados são ainda um componente principal do .NET Framework Providers Dados, TableAdapters são componentes gerados pelo designer que simplificam o processo de mover dados entre seu aplicativo e um banco de dados.Para obter mais informações sobre como trabalhar com TableAdapters, consulte Visão geral do TableAdapter. |
| Dica: |
|---|
Para configurar parâmetros depois de fazer alterações na demonstrativo SQL para um comando, você pode escolher o Regenerar a coleção de parâmetros para este comando opção no construtor de consultas. |
| Observação: |
|---|
As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritas na Ajuda, dependendo das configurações ativas ou configurações de edição.Para alterar as configurações, escolher Importar e exportar configurações on the Ferramentas menu.Para obter mais informações, consulte Configurações do Visual Studio. |
Para configurar parâmetros para um adaptador de dados
Crie um adaptador de dados.Para obter detalhes, consulte Creating Data Adapters.
No designer do formulário ou componente, selecione o adaptador de dados e então abra a janela Properties.
Expanda o objeto de comando para o qual você deseja configurar parâmetros (por exemplo, o UpdateCommand) e então na propriedade Parameters, clique nas reticências botão (...) para abrir a janela Parameter Collection Editor.
Para criar um novo objeto de parâmetro, clique em Add.
Coloque o novo parâmetro no local do índice correto na coleção para esse parâmetro clicando nas setas abaixo de Sort para movê-lo.
Para definir as propriedades de parâmetro, selecione o parâmetro na lista Members e em seguida, use a grade de propriedades no lado direito.A tabela a seguir lista propriedades que você normalmente define.
Propriedade
Descrição
Coluna Fonte
O nome de uma coluna em uma tabela do DataSet da qual o valor do parâmetro será lido.Essa propriedade é usada com parâmetros que preenchem valores em uma instrução UPDATE, INSERT, ou DELETE (ou procedimentos armazenados equivalentes).
Versão Fonte
Se o valor do parâmetro está sendo derivado através da propriedade SourceColumn, SourceVersion especifica qual versão de um registro de conjunto de dados deve ser usada como a fonte do valor do parâmetro:
Original - o valor da coluna como ele foi lido a partir do banco de dados.Você usa esta opção quando você precisa do valor de uma coluna antes de ela ser alterada.Um exemplo é quando um chave primária está sendo alterada, mas você precisa da chave antiga para localizar o registro no banco de dados.
Atual - o valor da coluna após um registro foi atualizado.Isso é geralmente o valor a ser gravado no banco de dados.
Default - o valor para o qual uma coluna é definida se nenhum valor for fornecido explicitamente.
Valor
Um valor explícito para definir o parâmetro.Esta propriedade é geralmente definida em tempo de execução em vez de estaticamente em tempo de design.
A propriedade Value tem precedência sobre a propriedade SourceColumn se ambas estiverem definidas.
Parâmetro nomeado
Um valor Booleano que indica se o parâmetro corresponde a uma variável (normalmente com o formato @parametername) ou a um espaço reservado (normalmente um ponto de interrogação).Se você estiver trabalhando com um objeto SqlConnection e estiver usando parâmetros nomeados, defina isso para true.
Tipo DB, precisão, escala, tamanho
Informações sobre o tipo de dados nativo (no armazenamento de dados) do valor do parâmetro.O valor do parâmetro é convertido dentro ou para fora do tipo especificado por você.
Direção
Uma especificação para saber se o valor do parâmetro está sendo passado para o comando ou de volta:
Input - o valor está sendo passado para o comando.Este é o padrão.
Output - o valor está sendo passado de volta de um procedimento armazenado.(Não aplicável para instruções SQL.)
InputOutput - o valor é passado para um procedimento armazenado e passado de volta, geralmente com um valor modificado.
ReturnValue - o valor é um valor de retorno explícito.Por padrão, o valor retornado é o primeiro item (valor de índice zero) na coleção de parâmetros.
Nome do Parâmetro
Um nome pelo qual você pode se referir ao parâmetro na coleção, em vez de referenciá-lo pelo seu valor de índice.Embora não seja necessário, um nome de parâmetro é recomendado para a facilidade de manutenção.
Clique em OK para fechar a janela Parameter Collection Editor.
Repita as etapas 3 a 7 para configurar parâmetros para outros objetos de comando.