Propriedade RecordSource

Aplicável a

Objeto Form

Objeto Report

Você pode usar a propriedade RecordSource para especificar a fonte de dados para um formulário ou relatório. Cadeia de caracteres de leitura/gravação.

expressão.RecordSource

expressão Obrigatória. Uma expressão que retorna um dos objetos na lista Aplica-se a.

Comentários

As configurações da propriedade RecordSource podem ser um nome de tabela, nome de consulta ou instrução SQL. Por exemplo, você pode usar as configurações a seguir.

Configuração de exemplo

Descrição

Funcionários

Um nome de tabela especificando a tabela Funcionários como a fonte de dados.

SELECT Orders!OrderDate FROM Orders;

Uma instrução SQL especificando o campo OrderDate na tabela Pedidos como a fonte de dados. Você pode vincular um controle no formulário ou relatório para o campo OrderDate na tabela Pedidos Configurando a propriedade ControlSource do controle para OrderDate.


Observação: Você pode definir a propriedade RecordSource usando a folha de propriedades do formulário ou relatório, uma macro ou o código do Visual Basic for Applications (VBA).

No VBA, use expressão de cadeia de caracteres para definir essa propriedade.

Observação: Alterar a fonte de registro de um formulário ou relatório aberto causa uma repetição automática da consulta dos dados subjacentes. Se a propriedade Recordset de um formulário for definida em tempo de execução, a propriedade RecordSource do formulário será atualizada.

Depois de criar um formulário ou relatório, você poderá alterar sua fonte de dados, alterando a propriedade RecordSource. A propriedade RecordSource também será útil se você quiser criar um formulário ou relatório reutilizável. Por exemplo, você pode criar um formulário que incorpora um design padrão e, em seguida, copiá-lo e alterar a propriedade RecordSource para exibir dados de uma tabela, consulta ou instrução SQL diferente.

Limitar o número de registros presentes na fonte de registro de um formulário pode melhorar o desempenho, especialmente quando o aplicativo estiver em execução em uma rede. Por exemplo, você pode definir a propriedade RecordSource de um formulário uma instrução SQL que retorna um único registro e altera a fonte de registro do formulário dependendo dos critérios selecionados pelo usuário.

Exemplo

O exemplo a seguir define a propriedade RecordSource de um formulário para a tabela Clientes:

Forms!frmCustomers.RecordSource = "Customers"

O próximo exemplo altera a fonte de registro de um formulário para um único registro na tabela Clientes, dependendo do nome de empresa selecionado no controle da caixa de combinação do cmboCompanyName. A caixa de combinação é preenchida por uma instrução SQL que retorna a ID do cliente (na coluna associada) e o nome da empresa. A CustomerID tem um tipo de dados de texto.

Sub cmboCompanyName_AfterUpdate()
Dim strNewRecord As String
strNewRecord = "SELECT * FROM Customers " _
& " WHERE CustomerID = '" _
& Me!cmboCompanyName.Value & "'"
Me.RecordSource = strNewRecord
End Sub
Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×