Objeto Record (ADO)

  • Artigo

Representa uma linha de um Recordset ou do provedor de dados ou um objeto retornado por um provedor de dados semiestruturado, por exemplo, 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 é executada uma consulta SQL que seleciona apenas uma linha. Ou um objeto Record pode ser obtido diretamente de um objeto Recordset. Ou um Record 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 de objetos Record.

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

O objeto Record também pode ser usado por provedores de dados semiestruturados, como o Provedor OLE DB da Microsoft para Publicação na Internet, para modelar namespaces estruturados em árvore. Cada nó na árvore é um objeto Record com colunas associadas. As colunas podem representar os atributos desse nó e outras informações relevantes. O objeto Record pode representar um nó folha e um nó não folha na estrutura da árvore. Um nó não folha tem outros nós como conteúdo, mas um nó folha não têm esse conteúdo. O nó folha normalmente contém fluxos binários de dados e o nó não folha também pode ter um fluxo binário padrão associado a ele. As propriedades no objeto Record identificam o tipo de nó.

O objeto Record também representa uma maneira alternativa de navegar por dados hierarquicamente organizados. Um objeto Record pode ser criado para representar a raiz de uma subconsulta específica em uma estrutura de árvore grande e novos objetos Record podem ser abertos para representar nós filho.

Um recurso (por exemplo, um arquivo ou diretório) pode ser identificado exclusivamente por uma URL absoluta. Um objeto Connection é criado implicitamente e definido como o objeto Record quando o Record é aberto usando uma URL absoluta. Um objeto Connection pode ser explicitamente definido como o objeto Record por meio da propriedade ActiveConnection. Os arquivos e diretórios que podem ser acessados usando o objeto Connection definem o contexto no qual as operações Record podem ocorrer.

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

Observação

As URLs que usam o esquema HTTP invocarão automaticamente o Provedor Microsoft OLE DB para Publicação na Internet. Para obter mais informações, confira URLs absolutas e relativas.

Um objeto Connection está associado a cada objeto Record. Portanto, as operações de objeto Record podem fazer parte de uma transação invocando métodos de transação de objeto Connection.

O objeto Record não dá suporte a eventos ADO e, portanto, não responderá às notificações.

Com os métodos e as propriedades de um objeto Record, você pode fazer o seguinte:

  • Definir ou retornar o objeto Connection associado com a propriedade ActiveConnection.

  • Indicar permissões de acesso com a 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 do qual o Record é derivado com a propriedade Source.

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

  • Indique o tipo de Registro - simples, coleção ou documento estruturado - com a propriedade RecordType.

  • Interromper 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 diretórios e subdiretórios, representados por um Record com o método DeleteRecord.

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

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

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

O objeto Record é seguro para scripts.

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

Confira também

Coleção Fields (ADO)
Coleção Properties (ADO)
Registros e fluxos
Objeto Recordset (ADO)