Propriedade SubForm.LinkChildFields (Access)

Use a propriedade LinkChildFields (juntamente com a propriedade LinkMasterFields ) para especificar como o Microsoft Access vincula registros em um formulário ou relatório a registros em um objeto subforma, sub-relatório ou inserido, como um gráfico. Se essas propriedades forem definidas, o Access atualizará automaticamente o registro relacionado no subforma ao alterar para um novo registro em um formulário principal. String de leitura/gravação.

Sintaxe

expressão. LinkChildFields

Expressão Uma variável que representa um objeto SubForm .

Comentários

Você pode definir as propriedades LinkChildFields e LinkMasterFields para o subformulário, sub-relatório ou objeto incorporado, da seguinte maneira:

• Para a propriedade LinkChildFields, insira o nome de um ou mais campos de vinculação no objeto subformforma, sub-relatório ou inserido.
• Para a propriedade LinkMasterFields, insira o nome de um ou mais campos de vinculação ou controles no formulário ou relatório principal.

Use o Subform/Subreport Field Linker para definir essas propriedades escolhendo o botão Compilar à direita da caixa de propriedade na folha de propriedades.

As propriedades podem ser definidas somente no modo de Design ou durante o evento Open de um formulário ou relatório.

Os campos ou controles que você usa para definir essas propriedades não precisam ter os mesmos nomes, mas devem conter o mesmo tipo de dados e ter o mesmo ou um tipo de dados compatível e tamanho de campo. Por exemplo, um campo AutoNumber é compatível com um campo Número se a propriedade FieldSize para o campo Número for definida como Long Integer.

Use o nome de um controle (incluindo o nome de um controle calculado) para definir a propriedade LinkMasterFields , mas não é possível usar o nome de um controle para definir a propriedade LinkChildFields . Se você quiser usar um valor calculado como o link para um subformulário, sub-relatório ou objeto incorporado, definir um campo calculado na consulta de base do objeto filho e defina a propriedade LinkChildFields ao campo.

Quando você especifica mais de um nome de campo ou de controle nas configurações dessas propriedades, você precisa inserir o mesmo número de campos ou controles na definição de cada propriedade e separar os nomes com ponto-e-vírgula (;).

Ao criar um subforma ou sub-relatório arrastando um formulário ou relatório da janela Banco de Dados para outro formulário ou relatório ou usando o Assistente de Formulário, o Access define automaticamente as propriedades LinkChildFields e LinkMasterFields nas seguintes condições:

• O formulário ou relatório principal e o objeto filho são baseados em tabelas, e uma relação entre essas tabelas foi definida com o comando Relações. O Access usa os campos que relacionam as duas tabelas como os campos de vinculação.

• Quando o formulário ou relatório principal é baseado em uma tabela com uma chave primária e quando o subformulário ou sub-relatório é baseado em uma tabela ou consulta que contenha um campo com o mesmo nome e o mesmo tipo de dados que (ou compatível com) a chave primária. O Access usa a chave primária da tabela subjacente do objeto principal e o campo de nome idêntico da tabela ou consulta subjacente do objeto filho como os campos de vinculação.

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.