Campos fornecidos pelo provedor e registros

Aplica-se ao: Access 2013, Office 2013

Quando um objeto Record é aberto, sua origem pode ser a linha atual de um Recordset aberto, uma URL absoluta ou uma URL relativa em conjunto com um objeto Connection aberto.

Se Record for aberto a partir de um Recordset, a coleção Fields com o objeto Record conterá todos os campos do Recordset, além de qualquer campo adicionado pelo provedor subjacente.

O provedor pode inserir campos adicionais que funcionem como características complementares de Record. Como resultado, um Record poderá ter campos exclusivos que não façam parte de Recordset como um todo ou qualquer Record derivado de outra linha de Recordset.

Por exemplo, todas as linhas de um Recordset derivadas de uma fonte de dados de email podem ter colunas como De, Para e Assunto. Um Record derivado desse Recordset terá os mesmos campos. Entretanto, o Record também pode ter outros campos exclusivos da mensagem específica representada por esse Record, como Anexo e Com cópia.

Embora o objeto Record e a linha atual de Recordset tenham os mesmos campos, eles são diferentes, pois os objetos Record e Recordset possuem métodos e propriedades diferentes.

Um mesmo campo mantido por Record e por Recordset pode ser modificado em um desses dois objetos. Entretanto, ele não pode ser excluído do objeto Record, embora o provedor subjacente possa permitir a configuração do campo como nulo.

Depois que Record for aberto, você poderá adicionar campos por programação. Você também poderá excluir os campos adicionados, mas não poderá excluir campos do Recordset original.

Também será permitido abrir o objeto Record diretamente de uma URL. Nesse caso, os campos adicionados a Record dependerão do provedor subjacente. No momento, a maioria dos provedores adiciona um conjunto de campos que descrevem a entidade representada por Record. Se a entidade consistir em um fluxo de bytes, como no caso de um arquivo simples, um objeto Stream geralmente poderá ser aberto a partir de Record.

Campos especiais para provedores de fonte de documentos

Uma classe especial de provedores, denominada provedores de fonte 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 fonte de documentos preenche esses objetos com um conjunto exclusivo de campos que descrevem as características do documento, em vez do documento real. Em geral, um campo contém uma referência a Stream que representa o documento.

Esses campos constituem um record ou um recordset de recurso e estão listados no Apêndice A: Provedores para os provedores específicos que oferecem suporte a eles.

Duas constantes indexam a coleção Fields de um Record ou Recordset de recurso para a recuperação de um par de campos comumente utilizados. 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 fonte de documentos não oferece suporte à coleção Properties dos objetos Record e Field. O conteúdo da coleção Properties é nulo para esses objetos.

Um provedor de fonte de documentos pode adicionar uma propriedade específica de provedor, como Datasource Type, para identificar um provedor desse tipo. Para obter mais informações sobre como determinar o seu tipo de provedor, consulte a documentação do provedor.

Colunas do conjunto de registros de recurso

Um conjunto de registros de recurso 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	True se o recurso estiver oculto. Nenhuma linha será retornada, a menos que o comando que estiver criando o conjunto de linhas selecione explicitamente as linhas em que RESOURCE_ISHIDDEN seja True.
RESOURCE_ISREADONLY	AdBoolean	True se o recurso for somente leitura. Qualquer tentativa de abrir esse recurso com DBBINDFLAG_WRITE não terá êxito com DB_E_READONLY. Esta propriedade poderá ser editada mesmo quando o recurso for aberto somente para leitura.
RESOURCE_CONTENTTYPE	AdVarWChar	Indica o provável uso do documento — por exemplo, o depoimento de um advogado. 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 é armazenado o conteúdo.
RESOURCE_CREATIONTIME	adFileTime	Somente leitura. Indica uma estrutura FILETIME que contém a hora em que o recurso foi criado. O tempo é relatado 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 a esse 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 a esse membro desta vez.
RESOURCE_STREAMSIZE	asUnsignedBigInt	Somente leitura. Indica o tamanho, em bytes, do fluxo padrão do recurso.
RESOURCE_ISCOLLECTION	AdBoolean	Somente leitura. True se o recurso for uma coleção, por exemplo, um diretório. False se o recurso for um arquivo simples.
RESOURCE_ISSTRUCTUREDDOCUMENT	AdBoolean	True se o recurso for um documento estruturado. Caso contrário, será False. Pode ser uma coleção ou um arquivo simples.
DEFAULT_DOCUMENT	AdVarWChar	Somente leitura. Indica que o recurso contém uma URL para o documento simples padrão de uma pasta ou para um documento estruturado. Usado quando o fluxo padrão for solicitado de um recurso. Esta propriedade estará em branco para um arquivo simples.
CHAPTERED_CHILDREN	AdChapter	Somente leitura. Opcional. Indica o capítulo do conjunto de linhas contendo o filho do recurso. (O OLE DB Provider for Internet Publishing 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 de um documento estruturado.