Record e campi specificati dal provider
Quando si apre un oggetto Record, la relativa origine può essere la riga corrente di un oggetto Recordset aperto, un URL assoluto o un URL relativo insieme a un oggetto Connection aperto.
Se l'oggetto Record viene aperto da un oggetto Recordset, la raccolta Fields dell'oggetto Record conterrà tutti i campi dell'oggetto Recordset, oltre a tutti i campi aggiunti dal provider sottostante.
Il provider può inserire campi aggiuntivi che fungono da caratteristiche supplementari dell'oggetto Record. Di conseguenza, un oggetto Record può avere campi univoci non inclusi nell'oggetto Recordset nel suo complesso o in qualsiasi oggetto Record derivato da un'altra riga dell'oggetto Recordset.
Ad esempio, tutte le righe di un oggetto Recordset derivate da un'origine dati di posta elettronica possono contenere colonne come Da, A e Oggetto. Un oggetto Record derivato da tale oggetto Recordset avrà gli stessi campi. Tuttavia, l'oggetto Record può avere anche altri campi univoci per il messaggio specifico rappresentato da tale oggetto Record come Allegato e Cc (copia per conoscenza).
Anche se l'oggetto Record e la riga corrente dell'oggetto Recordset hanno gli stessi campi, sono diversi perché gli oggetti Record e Recordset hanno metodi e proprietà diversi.
Un campo in comune negli oggetti Record e Recordset può essere modificato in entrambi gli oggetti. Tuttavia, il campo non può essere eliminato nell'oggetto Record, anche se il provider sottostante può supportare l'impostazione del campo su Null.
Dopo l'apertura dell'oggetto Record, è possibile aggiungere campi a livello di codice. È anche possibile eliminare i campi aggiunti, ma non è possibile eliminare i campi dall'oggetto Recordset originale.
È anche possibile aprire l'oggetto Record direttamente da un URL. In questo caso, i campi aggiunti all'oggetto Record dipendono dal provider sottostante. Attualmente, la maggior parte dei provider aggiunge un set di campi che descrivono l'entità rappresentata dall'oggetto Record. Se l'entità è costituita da un flusso di byte, come un semplice file, in genere è possibile aprire un oggetto Stream dall'oggetto Record.
Campi speciali per i provider di origine documenti
Una classe speciale di provider, denominata provider di origine documenti, gestisce cartelle e documenti. Quando un oggetto Record rappresenta un documento o un oggetto Recordset rappresenta una cartella di documenti, il provider di origine documenti popola tali oggetti con un set univoco di campi che descrivono le caratteristiche del documento anziché il documento effettivo stesso. In genere, un campo contiene un riferimento all'oggetto Stream che rappresenta il documento.
Questi campi costituiscono un record o un recordset di risorse e sono elencati per i provider specifici che li supportano nell'Appendice A: Provider.
Due costanti indicizzano la raccolta Fields di un oggetto Record o Recordset di risorse per recuperare una coppia di campi di uso comune. La proprietà Value dell'oggetto Field restituisce il contenuto desiderato.
Il campo a cui si accede con la costante adDefaultStream contiene un flusso predefinito associato all'oggetto Record o Recordset. Il provider assegna un flusso predefinito a un oggetto.
Il campo a cui si accede con la costante adRecordURL contiene l'URL assoluto che identifica il documento.
Un provider di origine documenti non supporta la raccolta Properties degli oggetti Record e Field. Il contenuto della raccolta Properties è Null per tali oggetti.
Un provider di origine documenti può aggiungere una proprietà specifica del provider, come Datasource Type, per identificare se si tratta di un provider di origine documenti. Per altre informazioni su come determinare il tipo di provider, vedere la documentazione del provider.
Colonne del recordset di risorse
Un recordset di risorse è costituito dalle colonne seguenti.
| Nome colonna | Tipo | Descrizione |
|---|---|---|
| RESOURCE_PARSENAME | AdVarWChar | Sola lettura. Indica l'URL della risorsa. |
| RESOURCE_PARENTNAME | AdVarWChar | Sola lettura. Indica l'URL assoluto del record padre. |
| RESOURCE_ABSOLUTEPARSENAME | AdVarWChar | Sola lettura. Indica l'URL assoluto della risorsa, ovvero la concatenazione di PARENTNAME e PARSENAME. |
| RESOURCE_ISHIDDEN | AdBoolean | True se la risorsa è nascosta. Non verranno restituite righe a meno che il comando che crea il set di righe non selezioni in modo esplicito le righe in cui RESOURCE_ISHIDDEN è True. |
| RESOURCE_ISREADONLY | AdBoolean | True se la risorsa è di sola lettura. Tenta di aprire questa risorsa con DBBINDFLAG_WRITE e avrà esito negativo con DB_E_READONLY. Questa proprietà può essere modificata anche quando la risorsa è stata aperta solo per la lettura. |
| RESOURCE_CONTENTTYPE | AdVarWChar | Indica l'uso probabile del documento, ad esempio il mandato di un avvocato. Può corrispondere al modello di Office usato per creare il documento. |
| RESOURCE_CONTENTCLASS | AdVarWChar | Indica il tipo MIME del documento, indicando il formato come "text/html". |
| RESOURCE_CONTENTLANGUAGE | AdVarWChar | Indica la lingua in cui è archiviato il contenuto. |
| RESOURCE_CREATIONTIME | adFileTime | Sola lettura. Indica una struttura FILETIME che contiene l'ora di creazione della risorsa. L'ora è riportata in formato UTC (Coordinated Universal Time). |
| RESOURCE_LASTACCESSTIME | AdFileTime | Sola lettura. Indica una struttura FILETIME che contiene l'ora dell'ultimo accesso alla risorsa. L'ora è in formato UTC. I membri FILETIME sono zero se il provider non supporta questo membro temporale. |
| RESOURCE_LASTWRITETIME | AdFileTime | Sola lettura. Indica una struttura FILETIME che contiene l'ora dell'ultima scrittura della risorsa. L'ora è in formato UTC. I membri FILETIME sono zero se il provider non supporta questo membro temporale. |
| RESOURCE_STREAMSIZE | asUnsignedBigInt | Sola lettura. Indica le dimensioni del flusso predefinito della risorsa, in byte. |
| RESOURCE_ISCOLLECTION | AdBoolean | Sola lettura. True se la risorsa è una raccolta, ad esempio una directory. False se la risorsa è un semplice file. |
| RESOURCE_ISSTRUCTUREDDOCUMENT | AdBoolean | True se la risorsa è un documento strutturato. True se la risorsa non è un documento strutturato. Potrebbe trattarsi di una raccolta o di un semplice file. |
| DEFAULT_DOCUMENT | AdVarWChar | Sola lettura. Indica che questa risorsa contiene un URL del documento semplice predefinito di una cartella o di un documento strutturato. Usato quando viene richiesto il flusso predefinito da una risorsa. Questa proprietà è vuota per un file semplice. |
| CHAPTERED_CHILDREN | AdChapter | Sola lettura. Facoltativo. Indica il capitolo del set di righe contenente gli elementi figlio della risorsa. Il provider OLE DB per Internet Publishing non usa questa colonna. |
| RESOURCE_DISPLAYNAME | AdVarWChar | Sola lettura. Indica il nome visualizzato della risorsa. |
| RESOURCE_ISROOT | AdBoolean | Sola lettura. True se la risorsa è la radice di una raccolta o di un documento strutturato. |