Método DoCmd.SetParameter (Access)

  • Artigo

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.