Objeto Fields

<< Clique para Mostrar o Sumário >>

 

Objeto Fields

O objeto Fields Fields representa uma coleção de Campos de um Histórico em uma tabela. Este objeto é criado automaticamente ao adicionar um Histórico na aplicação, e contém um Campo chamado E3TimeStamp, que representa a estampa de tempo em que o valor do registro foi buscado.

Para inserir novos Campos, clique com o botão direito do mouse no objeto Fields e selecione a opção Inserir - Campo de Histórico ou selecione o objeto Fields e clique em Adicionar Adicionar - Campo de Histórico na barra de ferramentas do Histórico. Para remover um Campo, clique com o botão direito do mouse no Campo e selecione a opção Deletar ou selecione um Campo e clique em Remover Remover na barra de ferramentas do Histórico.

 

NOTAS

O Campo E3TimeStamp é somente para leitura e não pode ser removido do objeto Fields.

É possível arrastar e soltar Campos de Histórico de um Histórico para outro. Entretanto, a propriedade PrimaryKey de um Campo de Histórico não é persistida após copiar este Campo dentro de um mesmo Histórico, pois esta propriedade é uma informação do Histórico e não do Campo.

Em aplicações criadas antes da versão 5.0 do E3, a propriedade Fields do Histórico é uma coleção padrão, que suporta o método Item para acessar os Campos disponíveis. A partir da versão 5.0, esta propriedade também retorna o objeto Fields, nativo do E3, e portanto a forma de acesso aos Campos é diferente para ambas as formas. O exemplo a seguir demonstra a forma correta de utilização como objeto nativo e como coleção em um script.

Aplicações salvas na versão 5.0 convertem os objetos Histórico do formato de coleção para objeto nativo e NÃO podem mais ser abertas em versões anteriores.

 

Para acessar a coleção de Campos de Histórico tanto como uma coleção quanto como um objeto nativo, use os formatos descritos no exemplo a seguir.

'A aplicação contém um objeto chamado Hist1
'que contém um Campo chamado Campo1.
'Para acessar este Campo como coleção,
'use a seguinte sintaxe:
Set campoColecao = Application.GetObject("Hist1").Fields.Item("Campo1")
'Para acessar o mesmo Campo como objeto nativo,
'use a seguinte sintaxe:
Set campoNativo = Application.GetObject("Hist1.Fields.Campo1")

 

Consulte o tópico Campo de Histórico para mais informações sobre as propriedades dos Campos de Histórico existentes em um objeto Fields.

Esta página foi útil?