Registros e campos de Provider-Supplied
Quando um objeto Record é aberto, sua origem pode ser a linha atual de um conjunto de registros aberto, uma URL absoluta ou uma URL relativa em conjunto com um objeto de Conexão aberto.
Se o de Registro de for aberto de um Recordset, o objeto Fields coleção 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 conjunto de registros derivadas de uma fonte de dados de email podem ter colunas como De, Para e Assunto. Um registro derivado desse recordset terá os mesmos campos. No entanto, a de Registro também pode ter outros campos exclusivos para a mensagem específica representada por esse de Registro, como Anexo e Cc (cópia de carbono).
Embora o objeto Record e a linha atual do objeto Recordset tenham os mesmos campos, eles são diferentes porque os objetos Record e Recordset possuem métodos e propriedades diferentes.
Um campo mantido em comum pelo Registro e pelo conjunto de registros pode ser modificado em ambos os objetos. 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 registro for aberto, você poderá adicionar campos programaticamente. Você também pode excluir campos que adicionou, mas não pode excluir campos do conjunto de registros original.
Você também pode abrir o objeto registro diretamente de uma URL. Nesse caso, os campos adicionados ao Registro dependem do provedor base. 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 do Registro.
Campos especiais para provedores de origem de documento
Uma classe especial de provedores, chamada provedores de origem de documentos, 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. Normalmente, um campo contém uma referência ao Stream que representa o documento.
Esses campos constituem um de registro de recurso ou de conjunto de registros e são listados para os provedores específicos que dão suporte a eles no apêndice A: provedores.
Duas constantes indexam a coleção Fields de um de registro de de recurso ou recordset para recuperar um par de campos comumente usados. A propriedade Field objeto Value retorna o conteúdo desejado.
O campo acessado com a constante adDefaultStream contém um fluxo padrão associado ao objeto Recordset ou ao de registro. 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 de documento não dá suporte à coleção de objetos Record e Field de Properties. O conteúdo da coleção Properties é nulo para esses objetos.
Um provedor de origem de documento pode adicionar uma propriedade específica do provedor, como Tipo de Fonte de Dados, para identificar se trata de um provedor de origem de documento. Para obter mais informações sobre como determinar seu tipo de provedor, consulte a documentação do provedor.
Colunas do conjunto de registros de recursos
Um conjunto de registros de recursos consiste nas seguintes colunas.
| Nome da coluna | Tipo | 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 | Verdadeiro 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. |
| Tipo de Conteúdo do Recurso | AdVarWChar | Indica o uso provável do documento, por exemplo, o resumo 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 o idioma no qual o conteúdo é armazenado. |
| TEMPO_CRIAÇÃO_RECURSO | 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 de FILETIME serão zero se o provedor não der suporte a esse membro de tempo. |
| 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 são zero se o provedor não der suporte a esse membro de tempo. |
| RESOURCE_STREAMSIZE | comoInteiroNãoSinalizado | Somente leitura. Indica o tamanho do fluxo padrão do recurso, em bytes. |
| RECURSO_ÉCOLEÇÃO | AdBoolean | Somente leitura. True se o recurso for uma coleção, como um diretório. False se o recurso for um arquivo simples. |
| RECURSO_ÉDOCUMENTOESTRUTURADO | AdBoolean | Verdadeiro 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. |
| DOCUMENTO_PADRÃO | 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 está em branco para um arquivo simples. |
| CRIANÇAS_CAPÍTULADAS | AdChapter | Somente leitura. Opcional. Indica a seção do conjunto de linhas que contém os filhos do recurso. (O provedor OLE DB para publicação na Internet não usa esta coluna.) |
| RESOURCE_DISPLAYNAME | AdVarWChar | Somente leitura. Indica o nome de exibição do recurso. |
| RESOURCE_ISROOT | AdBoolean | Somente leitura. True se o recurso for a raiz de uma coleção ou documento estruturado. |
Consulte Também
Objeto de Registro (ADO)
apêndice A : provedores