Coleção Fields (ADO)

Contém todos os objetos Field de um objeto Recordset ou Record.

Comentários

Um objeto Recordset tem uma coleção Fields composta por objetos Field. Cada objeto Field corresponde a uma coluna no Recordset. Você pode preencher a coleção Fields antes de abrir o Recordset chamando o método Refresh na coleção.

Observação

Consulte o tópico do objeto Field para obter uma explicação mais detalhada de como usar objetos Field.

A coleção Fields tem um método Append, que cria e adiciona provisoriamente um objeto Field à coleção e um método Update, que finaliza quaisquer adições ou exclusões.

Um objeto Record tem dois campos especiais que podem ser indexados com constantes FieldEnum. Uma constante acessa um campo que contém o fluxo padrão de Record e a outra acessa um campo que contém a cadeia de caracteres de URL absoluta para o Record.

Determinados provedores (por exemplo, o Microsoft OLE DB Provider para Publicação de Internet) podem preencher a coleção Fields com um subconjunto de campos disponíveis para Record ou Recordset. Outros campos não serão adicionados à coleção até que sejam referenciados pelo nome ou indexados pelo código.

Se você tentar fazer referência a um campo inexistente por nome, um novo objeto Field será acrescentado à coleção Fields com Status de adFieldPendingInsert. Quando você chamar Update, o ADO criará um novo campo na fonte de dados, se permitido pelo provedor.

Esta seção contém o tópico a seguir.

• Propriedades, métodos e eventos da coleção Fields

Consulte Também

Objeto Campo