Aplica-se a
|
Objeto Form |
|
Objeto Report |
Pode utilizar a propriedade IntroduzirParâmetros para especificar ou determinar os parâmetros de entrada transmitidos a uma instrução SQL na propriedade OrigemDosRegistos de um formulário ou relatório ou de um procedimento armazenado quando utilizado como a origem de registos num projeto do Microsoft Access (.adp). Cadeia de leitura/escrita.
expressão.IntroduzirParâmetros
expressão Obrigatório. Uma expressão que devolve um dos objetos na lista Aplica-se A.
Observações
Pode definir esta propriedade ao utilizar a folha de propriedades ou um código VBA (Visual Basic for Applications).
Quando utilizada com a propriedade OrigemDosRegistos:
Uma cadeia da propriedade IntroduzirParâmetros de exemplo utilizada com uma instrução SQL na propriedade OrigemDosRegistos utilizaria a sintaxe seguinte.
state char=[Formulários]![nomedoformulário]![ListaDeEstados], anodasvendas smallint=[Formulários]![nomedoformulário]![Introduzir ano pretendido]
Isto resultaria na definição do parâmetro estado para o valor atual do controlo ListaDeEstados e seria pedido ao utilizador o parâmetro anodasvendas. Se existissem outros parâmetros que não se encontrassem nesta lista, ser-lhes-iam atribuídos valores predefinidos.
A consulta deveria ser executada com um marcador ? para cada parâmetro não predefinido na lista IntroduzirParâmetros.
Um comando de atualização ou de repetição da consulta no Microsoft Office Access 2007 acionaria uma nova execução da consulta. Os utilizadores podem fazer isto no código ao chamar o método Recordset.Requery padrão. Se o valor de um parâmetro estiver vinculado a um controlo no formulário, o valor atual do controlo é utilizado no momento da repetição da consulta. A consulta não é executada novamente de forma automática quando o valor do controlo é alterado.
Quando utilizada com um procedimento armazenado:
Uma cadeia da propriedade IntroduzirParâmetros de exemplo utilizada com um procedimento armazenado seria:
@state char=[Formulários]![nomedoformulário]![ListaDeEstados], @anodasvendas smallint=[Formulários]![nomedoformulário]![Introduzir ano pretendido]
Isto resultaria na definição do parâmetro @state para o valor atual do controlo ListaDeEstados e seria pedido ao utilizador o parâmetro @anodasvendas. Se existissem outros parâmetros do procedimento armazenado que não se encontrassem nesta lista, ser-lhes-iam atribuídos valores predefinidos.
O procedimento armazenado deve ser executado ao utilizar uma cadeia de comandos que contenha a sintaxe {call } com um marcador ? para cada parâmetro não predefinido na lista IntroduzirParâmetros.
Um comando de atualização ou de repetição da consulta no Access acionaria uma nova execução do procedimento armazenado. Os utilizadores podem fazer isto no código ao chamar o método Recordset.Requery padrão. Se o valor de um parâmetro estiver vinculado a um controlo no formulário, o valor atual do controlo é utilizado no momento da repetição da consulta. O procedimento armazenado não é executado novamente de forma automática quando o valor do controlo é alterado.
Esta caixa de diálogo do construtor é invocada quando um procedimento armazenado é selecionado pela primeira vez como a origem de registos de um formulário, se o procedimento armazenado tiver parâmetros. Após a criação inicial da cadeia IntroduzirParâmetros, esta mesma caixa de diálogo é utilizada como um construtor para alterar a cadeia. No entanto, neste caso a lista de parâmetros provém daquilo que já existe na cadeia.
Também é possível definir os valores dos parâmetros no código ao utilizar os objetos Command e Parameter do ActiveX Data Object (ADO). Se for devolvido um conjunto de resultados, pode ser vinculado um formulário ao mesmo ao definir a propriedade ConjuntoDeRegistos do formulário. A codificação do ADO é a única forma de tratar procedimentos armazenados que não devolve conjuntos de resultados, tais como as consultas de ação, consultas que devolvem parâmetros de saída ou consultas que devolvem múltiplos conjuntos de resultados.
