Objeto Record (ADO)
Representa uma linha de um Recordset ou do provedor de dados ou um objeto retornado por um provedor de dados semiestruturado, como um arquivo ou diretório.
Observações
Um objeto de registro representa uma linha de dados e tem algumas semelhanças conceituais com uma linha Recordset. Dependendo dos recursos do seu provedor, Os objetos de registro podem ser retornados diretamente do seu provedor em vez de uma linha recordset, 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 de 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 Campos no objeto registro. 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, é possível retornar à original do Recordset com a propriedade Source.
O objeto Record também pode ser usado por provedores de dados semiestruturados, como o provedor Microsoft OLE DB 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 registro pode representar um nó folha e um nó não folha na estrutura da árvore. Nós não folha têm outros nós como seu conteúdo, mas os nós folha não têm esse conteúdo. Nós folha normalmente contêm fluxos binários de dados e nós não folha também podem ter um fluxo binário padrão associado a eles. As propriedades no objeto Record identificam o tipo de nó.
O objeto Record também representa uma maneira alternativa de navegar por dados organizados hierarquicamente. Um objeto Record pode ser criado para representar a raiz de uma subárvore 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 de Registro quando o de Registro de é aberto usando uma URL absoluta. Um objeto Connection pode ser definido explicitamente 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 operações de registro 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.
Nota
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, consulte URLs absolutas e relativas.
Um objeto Connection está associado a cada objeto Record. Portanto, as operações de objeto de registro 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 do 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:
Defina ou retorne o objeto Connection associado à propriedade ActiveConnection.
Indique permissões de acesso com a propriedade modo.
Retorne a URL do diretório, se houver, que contenha o recurso representado pela de Registro com a propriedade ParentURL.
Indique a URL absoluta, a URL relativa ou a do conjunto de registros do qual o de Registro de é derivado com a propriedade Source.
Indique o status atual do de Registro com a propriedade state.
Indique o tipo de - simples, coleçãoou de documento estruturado com a propriedade RecordType.
Interrompa a execução de uma operação assíncrona com o método Cancelar.
Desassociar o registro de uma fonte de dados com o método Close.
Copie o arquivo ou o diretório representado por um de Registro para outro local com o método CopyRecord.
Exclua o arquivo, ou diretório e subdiretórios, representados por um de registro com o método DeleteRecord.
Abra um conjunto de registros que contém linhas que representam os subdiretórios e arquivos da entidade representada pela de Registro com o método GetChildren.
Mova (renomeie) o arquivo, ou diretório e subdiretórios, representados por um de Registro para outro local com o método MoveRecord.
Associe o registro a uma fonte de dados existente ou crie um novo arquivo ou diretório com o método Open.
O objeto registro é seguro para scripts.
Esta seção contém o tópico a seguir.
Consulte Também
da Coleção Fields (ADO)
da coleção Properties (ADO)
registros e fluxos
do objeto Recordset (ADO)