Método DoCmd.RunSQL (Access)

O método RunSQL executa a ação RunSQL no Visual Basic.

Sintaxe

expressão. RunSQL (SQLStatement, UseTransaction)

expression Uma variável que representa um objeto DoCmd.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
SQLStatement	Obrigatório	Variant	Uma cadeia de expressão que é uma instrução SQL válida para uma consulta de ação ou uma consulta de definição de dados. Ela usa uma instrução INSERT INTO, DELETE, SELECT...INTO, UPDATE, CREATE TABLE, ALTER TABLE, DROP TABLE, CREATE INDEX ou DROP INDEX. Inclua uma cláusula IN se desejar acessar outro banco de dados.
UseTransaction	Opcional	Variantes	Use True (1) para incluir essa consulta em uma transação. Use False (0) se não quiser usar uma transação. Se você deixar este argumento em branco, o padrão (True) será considerado.

Comentários

Use a ação RunSQL para executar uma consulta de ação do Microsoft Access usando a instrução SQL correspondente. Pode também executar uma consulta de definição de dados.

Esse método só se aplica aos bancos de dados access.

O comprimento máximo do argumento SQLStatement é de 32.768 caracteres (ao contrário do argumento de ação SQLStatement na janela Macro, cujo comprimento máximo é de 256 caracteres).

Exemplo

O exemplo a seguir atualiza a tabela Funcionários, alterando o título de cada gerente de vendas para Gerente Regional de Vendas.

Public Sub DoSQL() 
 
    Dim SQL As String 
     
    SQL = "UPDATE Employees" & _ 
          "SET Employees.Title = 'Regional Sales Manager'" & _ 
          "WHERE Employees.Title = 'Sales Manager'" 
 
    DoCmd.RunSQL SQL 
     
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.