Objeto Record (ADO)

Aplica-se ao: Access 2013, Office 2013

Representa uma linha de um Recordset ou do provedor de dados ou um objeto retornado pelo provedor de dados semi-estruturado, como um arquivo ou diretório.

Comentários

Um objeto Record representa uma linha de dados e tem algumas semelhanças conceituais com um Recordset de uma linha. Dependendo dos recursos do provedor, os objetos Record podem ser retornados diretamente do provedor em vez de um Recordset de uma linha, por exemplo, quando uma consulta SQL que seleciona apenas uma linha é executada. Ou um objeto Record pode ser obtido diretamente de um objeto Recordset . Ou um Registro pode ser retornado diretamente de um provedor para dados semiestruturados, como o provedor OLE DB do Microsoft Exchange.

Você pode exibir os campos associados ao objeto Record por meio da coleção Fields no objeto Record. O ADO permite colunas com valor de objeto, incluindo Recordset, SafeArray e valores escalares na coleção Fields dos objetos Record.

Se o objeto Record representar uma linha em um Recordset, será possível retornar para esse Recordset original com a propriedade Source.

O objeto Record também pode ser usado pelos provedores de dados semi-estruturados como o Microsoft OLE DB Provider for Internet Publishing para modelar os espaços para nome em forma de árvore. Cada nó em uma árvore é um objeto Record com as colunas associadas. As colunas podem representar os atributos desse nó e outras informações relevantes. O objeto Record pode representar tanto um nó folha como um nó não folha na estrutura em árvore. Os nós não folha têm outros nós como seus conteúdos enquanto os nós folha não têm esses conteúdos. Geralmente, os nós folha contêm fluxos de dados binários enquanto os nós não folha também têm um fluxo binário padrão associado. As propriedades do objeto Record identificam o tipo de nó.

O objeto Record também representa uma forma alternativa de navegar hierarquicamente nos dados organizados. É possível criar um objeto Record para representar a raiz de uma subárvore em uma estrutura em árvore grande e os novos objetos Record podem ser abertos para representar nós filhos.

Um recurso (por exemplo, um arquivo ou um diretório) pode ser identificado exclusivamente por uma URL absoluta. Um objeto Connection será criado e definido de forma implícita como o objeto Record, quando o Record for aberto com uma URL absoluta. Um objeto Connection pode ser definido de forma implícita como o objeto Record por meio da propriedade ActiveConnection. Os arquivos e os diretórios acessíveis por meio do objeto Connection definem o contexto no qual as operações Record podem ocorrer.

A modificação dos dados e os métodos de navegação no objeto Record também aceitam uma URL relativa, que localiza um recurso usando uma URL absoluta ou o contexto do objeto Connection como um ponto de partida.

Um objeto Connection está associado a cada objeto Record. Por esse motivo, as operações do objeto Record podem fazer parte de uma operação pela chamada dos métodos de transação do objeto Connection.

O objeto Record não oferecer suporte aos eventos ADO e, por esse motivo, não responderá às notificações.

Com os métodos e as propriedades de um objeto Record, é possível fazer o seguinte:

• Definir ou retornar o objeto Connection associado à propriedade ActiveConnection.

• Indicar as permissões de acesso à propriedade Mode.

• Retornar a URL do diretório, se houver, que contém o recurso representado pelo Record com a propriedade ParentURL.

• Indicar a URL absoluta, a URL relativa ou o Recordset a partir do qual o Record é derivado com a propriedade Source.

• Indicar o status atual do Record com a propriedade State.

• Indicar o tipo de Record — simples, coleção ou documento estruturado — com a propriedade RecordType.

• Suspender a execução de uma operação assíncrona com o método Cancel.

• Desassociar o Record de uma fonte de dados com o método Close.

• Copiar o arquivo ou o diretório representado por um Record para outro local com o método CopyRecord.

• Excluir o arquivo ou o diretório e os subdiretórios, representado por um Record com o método DeleteRecord.

• Abrir um Recordset contendo linhas que representam os subdiretórios e os arquivos da entidade representados pelo Record com o método GetChildren.

• Mover (renomear) o arquivo ou o diretório e os subdiretórios, representado por um Record para outro local com o método MoveRecord.

• Associar o Record com uma fonte de dados existente ou criar um novo arquivo ou diretório com o método Open.