Método DoCmd.SetParameter (Access)
Use o método SetParameter para criar um parâmetro para uso pelos métodos BrowseTo, OpenForm, OpenQuery, OpenReport ou RunDataMacro .
Sintaxe
expressão. SetParameter (Nome, Expressão)
expression Uma variável que representa um objeto DoCmd.
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| Name | Obrigatório | Variant | O nome do parâmetro. O nome deve corresponder ao nome do parâmetro esperado pelo métodos BrowseTo, OpenForm, OpenQuery, OpenReport ou do método ExecutarMacrodeDados. |
| Expression | Obrigatório | Variant | Uma expressão que é avaliada como um valor que será atribuído ao parâmetro. |
Comentários
Você deve criar tantas chamadas ao método SetParameter quantas forem precisas para criar os parâmetros que necessários.
Cada chamada a SetParameter adiciona ou atualiza um único parâmetro em um conjunto de parâmetros interno. A coleção parameters é passada para o métodos BrowseTo, OpenForm, OpenQuery, OpenReport ou do método ExecutarMacrodeDados. Quando o método é executado, a coleção de parâmetros fornece os parâmetros necessários. Quando o método é concluído, a coleção de parâmetros é desmarcada.
Como cada um dos métodos que aceita parâmetros limpa a coleção parameters quando ele for concluído, você deve garantir que suas chamadas SetParameter precedem imediatamente a chamada para o método que emprega-los.
Exemplo
O exemplo de código a seguir cria dois parâmetros para serem usados pela macro de dados AdicionarComentário. Os dois parâmetros são chamados prmComment e prmRelatedID, respectivamente. O valor da caixa de texto txtComment é armazenado no parâmetro prmComment. O valor da caixa de texto txtId é armazenado no parâmetro prmRelatedID.
Private Sub cmdAddComment_Click()
DoCmd.SetParameter "prmComment", Me.txtComment
DoCmd.SetParameter "prmRelatedID", Me.txtId
DoCmd.RunDataMacro "Comments.AddComment"
End Sub
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.