Registros e campos fornecidos pelo provedor
Quando um objeto Record é aberto, a fonte dele pode ser a linha atual de um Recordset aberto, uma URL absoluta ou uma URL relativa em conjunto com um objeto Connection aberto.
Se o Record for aberto por meio de um Recordset, a coleção Fields do objeto Record conterá todos os campos do Recordset, além de todos os campos adicionados pelo provedor subjacente.
O provedor pode inserir campos adicionais que servem como características complementares do Record. Como resultado, um Record pode ter campos exclusivos que não estão no Recordset como um todo ou qualquer Record derivado de outra linha do Recordset.
Por exemplo, todas as linhas de um Recordset derivados de uma fonte de dados de email podem ter colunas como De, Para e Assunto. Um Record derivado desse Recordset terá os mesmos campos. No entanto, o Record também pode ter outros campos exclusivos para a mensagem específica representada por esse Record, como Anexo e Cc (cópia carbono).
Embora o objeto Record e a linha atual do Recordset tenham os mesmos campos, eles são diferentes porque os objetos Record e Recordset têm diferentes métodos e propriedades.
Um campo mantido em comum pelo Record e Recordset pode ser modificado em qualquer objeto. No entanto, o campo não pode ser excluído no objeto Record, embora o provedor subjacente possa dar suporte à definição do campo como nulo.
Depois que o Record for aberto, você poderá adicionar campos por meio de programação. Você também pode excluir os campos adicionados, mas não pode excluir os campos do Recordset original.
Você também pode abrir o objeto Record diretamente de uma URL. Nesse caso, os campos adicionados ao Record dependem do provedor subjacente. Atualmente, a maioria dos provedores adiciona um conjunto de campos que descrevem a entidade representada pelo Record. Se a entidade consistir em um fluxo de bytes, como um arquivo simples, um objeto Stream geralmente poderá ser aberto por meio do Record.
Campos especiais para provedores de origem do documento
Uma classe especial de provedores, chamada provedores de origem do documento, gerencia pastas e documentos. Quando um objeto Record representa um documento ou um objeto Recordset representa uma pasta de documentos, o provedor de origem do documento preenche esses objetos com um conjunto exclusivo de campos que descrevem características do documento em vez do próprio documento real. Normalmente, um campo contém uma referência ao Stream que representa o documento.
Esses campos constituem um recurso record ou recordset e são listados para os provedores específicos que dão suporte a eles em Apêndice A: Provedores.
Duas constantes indexam a coleção Fields de um recurso Record ou Recordset para recuperar um par de campos comumente usados. A propriedade Value do objeto Field retorna o conteúdo desejado.
O campo acessado com a constante adDefaultStream contém um fluxo padrão associado ao objeto Record ou Recordset. O provedor atribui um fluxo padrão a um objeto.
O campo acessado com a constante adRecordURL contém a URL absoluta que identifica o documento.
Um provedor de origem do documento não dá suporte à coleção Properties de objetos Record e Field. O conteúdo da coleção Properties é nulo para esses objetos.
Um provedor de origem do documento pode adicionar uma propriedade específica do provedor, como Datasource Type, para identificar se ele é um provedor de origem do documento. Para obter mais informações sobre como determinar seu tipo de provedor, confira a documentação do provedor.
Colunas do conjunto de registros de recursos
Um conjunto de registros de recursos consiste nas colunas a seguir.
| Nome da coluna | Type | Descrição |
|---|---|---|
| RESOURCE_PARSENAME | AdVarWChar | Somente leitura. Indica a URL do recurso. |
| RESOURCE_PARENTNAME | AdVarWChar | Somente leitura. Indica a URL absoluta do registro pai. |
| RESOURCE_ABSOLUTEPARSENAME | AdVarWChar | Somente leitura. Indica a URL absoluta do recurso, que é a concatenação de PARENTNAME e PARSENAME. |
| RESOURCE_ISHIDDEN | AdBoolean | True se o recurso estiver oculto. Nenhuma linha será retornada, a menos que o comando que cria o conjunto de linhas selecione explicitamente as linhas em que RESOURCE_ISHIDDEN é True. |
| RESOURCE_ISREADONLY | AdBoolean | True se o recurso for somente leitura. Tenta abrir esse recurso com DBBINDFLAG_WRITE e falhará com DB_E_READONLY. Essa propriedade pode ser editada mesmo quando o recurso foi aberto apenas para leitura. |
| RESOURCE_CONTENTTYPE | AdVarWChar | Indica o provável uso do documento, por exemplo, o processo de um advogado. Isso pode corresponder ao modelo do Office usado para criar o documento. |
| RESOURCE_CONTENTCLASS | AdVarWChar | Indica o tipo MIME do documento, indicando o formato como "text/html". |
| RESOURCE_CONTENTLANGUAGE | AdVarWChar | Indica a linguagem na qual o conteúdo é armazenado. |
| RESOURCE_CREATIONTIME | adFileTime | Somente leitura. Indica uma estrutura FILETIME que contém a hora em que o recurso foi criado. A hora é relatada no formato UTC (Tempo Universal Coordenado). |
| RESOURCE_LASTACCESSTIME | AdFileTime | Somente leitura. Indica uma estrutura FILETIME que contém a hora em que o recurso foi acessado pela última vez. A hora está no formato UTC. Os membros FILETIME serão zero se o provedor não der suporte ao membro desta vez. |
| RESOURCE_LASTWRITETIME | AdFileTime | Somente leitura. Indica uma estrutura FILETIME que contém a hora em que o recurso foi gravado pela última vez. A hora está no formato UTC. Os membros FILETIME serão zero se o provedor não der suporte ao membro desta vez. |
| RESOURCE_STREAMSIZE | asUnsignedBigInt | Somente leitura. Indica o tamanho do fluxo padrão do recurso, em bytes. |
| RESOURCE_ISCOLLECTION | AdBoolean | Somente leitura. True se o recurso for uma coleção, como um diretório. False se o recurso for um arquivo simples. |
| RESOURCE_ISSTRUCTUREDDOCUMENT | AdBoolean | True se o recurso for um documento estruturado. False se o recurso não for um documento estruturado. Pode ser uma coleção ou um arquivo simples. |
| DEFAULT_DOCUMENT | AdVarWChar | Somente leitura. Indica que esse recurso contém uma URL para o documento simples padrão de uma pasta ou um documento estruturado. Usado quando o fluxo padrão é solicitado de um recurso. Essa propriedade fica em branco para um arquivo simples. |
| CHAPTERED_CHILDREN | AdChapter | Somente leitura. Opcional. Indica o capítulo do conjunto de linhas que contém os filhos do recurso. (O OLE DB Provider para Publicação de Internet não usa esta coluna.) |
| RESOURCE_DISPLAYNAME | AdVarWChar | Somente leitura. Indica o nome para exibição do recurso. |
| RESOURCE_ISROOT | AdBoolean | Somente leitura. True se o recurso for a raiz de uma coleção ou um documento estruturado. |