Parameters Collection Editor
Permite que você crie e configure parâmetros (objetos OleDbParameter,SqlParameter,OdbcParameter e OracleParameter) associados com um Instrução SQL ou procedimento armazenado em TableAdapters e adaptadores de dados.
Editando a coleção de parâmetros
O Parameters Collection Editor é exibido quando você estiver usando a janela Properties para configurar um TableAdapter no Dataset Designer, ou um adaptador de dados em um formulário ou componente.
Selecione um TableAdapter na superfície Dataset Designer e selecione a propriedade Parameters na janela Properties para abrir o Parameters Collection Editor.
Abrir o nó para as propriedades SelectCommand, UpdateCommand, InsertCommand e DeleteCommand.
Editar a propriedade Parameters para abrir o Parameters Collection Editor.
.gif "Observação") Observação: |
|---|
Se você usar ferramentas de design de dados, sistema autônomo o Assistente de Configuração para o TableAdapter, ou o Assistente de configuração do adaptador de dados para configurar adaptadores, os parâmetros para o adaptador são configurados automaticamente. |
Nomeação de parâmetro
As instruções ou stored procedures nesses comandos podem ser definidos com espaços reservados de parâmetros.
Se você estiver usando um objeto OleDbDataAdapter, uma instrução usa um ponto de interrogação como um espaço reservado e pode ter esta aparência:
Select * From Customers Where City = ?
Se você estiver usando um objeto SqlDataAdapter, uma instrução que usa parâmetros nomeados pode ter esta aparência:
Select * From Customers Where City = @City
Se você estiver usando um objeto OracleDataAdapter, uma instrução que usa parâmetros nomeados Oracle pode ter esta aparência:
SELECT * FROM Customers WHERE CustomerID = :pCustomerID
| Observação: |
|---|
Para Oracle, quando usar parâmetros nomeados em uma instrução SQL ou stored procedure, você deve preceder o nome do parâmetro com um dois-pontos (:).No entanto, quando se referem a um parâmetro nomeado em outro lugar no seu código (por exemplo, ao chamar o Add método), não preceda o parâmetro nomeado com dois-pontos (:). O provedor de dados fornece o dois-pontos automaticamente. |
Adicionando parâmetros
A coleção Parameters para um comando (por exemplo, Parameters) contém uma lista de objetos de parâmetro que são usados em tempo de execução para passar valores às instruções ou aos procedimentos armazenados.Portanto, há um objeto parâmetro para cada valor do parâmetro que precise ser passados para um comando.
O editor é dividido em dois painéis.No painel esquerdo você adiciona e remove parâmetros e no painel direito você define propriedades para um parâmetro individual, entre eles:
Propriedade ParameterName, pela qual você pode se referir ao parâmetro no código.
Observação:O SqlDataAdapter classe requer parâmetros nomeados, assim, na SqlParameterobjetos, o nome sempre devem ser precedidos com "@".
Propriedade SourceColumn, que identifica de onde em um registro de dados o valor do parâmetro é proveniente.Esse valor é usado durante as atualizações; o adaptador de dados passa o valor de uma coluna específica para o comando de atualização.
Propriedade SourceVersion, que é usada em conjunto com a propriedade SourceColumn.Se um registro foi alterado no dataset, várias cópias do registro estão disponíveis, incluindo o valor original (como lido a partir da fonte de dados) e valor atual (após alterações).Ao especificar um valor de coluna para passar como um parâmetro, você seleciona qual dos dois valores deverá ser passado.Normalmente, o valor original é usado como um parâmetro em uma cláusula WHERE para identificar o registro no banco de dados, e o valor atual é usado nas cláusulas SET ou VALUES.
Propriedade Value, que é um valor literal explícito a ser passado como o parâmetro.Configurar essa propriedade substitui a propriedade SourceColumn; as duas propriedades são mutuamente exclusivas.
Para obter mais informações sobre parâmetros, consulte Parâmetros em comandos do adaptador de dados.
Lista User Interface Element
Adicionar
Crie um novo parâmetro na coleção.Por padrão, a tabela é denominada parâmetro n, onde n é um número sequencial.Você pode renomear a tabela definindo sua propriedade ParameterName na grade propriedades.Observação:O OleDbParameter coleção Editor não verifica se você está criando o número correto de parâmetros para o comando ou se eles são do tipo correto.
Parâmetros são comparados aos parâmetros nos espaços reservados nas instruções ou comandos por posição.Portanto, certifique-se que os parâmetros são ordenados corretamente na coleção.
Remove
Exclui o parâmetro selecionado da coleção.
Consulte também
Conceitos
Referência
Outros recursos
Conectando-se a Dados no Visual Studio
Preparando seu aplicativo para receber dados
Buscando dados em seu aplicativo
Exibindo dados em formulários em aplicativos do Windows