Record e campi Provider-Supplied
Quando viene aperto un oggetto Record, l'origine può essere la riga corrente di un Recordsetaperto, un URL assoluto o un URL relativo insieme a un oggetto Connection aperto.
Se il Record viene aperto da un Recordset, la collezione Fields dell'oggetto Record conterrà tutti i campi del Recordset, oltre a qualsiasi campo aggiunto dal provider sottostante.
Il provider può inserire campi aggiuntivi che fungono da caratteristiche supplementari del Record. Di conseguenza, un record può avere campi univoci non presenti nel recordset nel suo complesso o in qualsiasi record derivato da un'altra riga del recordset .
Ad esempio, tutte le righe di un oggetto Recordset derivate da un'origine dati di posta elettronica possono includere colonne quali From, To e Subject. Un Record derivato da tale Recordset avrà gli stessi campi. Tuttavia, il record può avere anche altri campi univoci per il messaggio specifico rappresentato da tale Record, ad esempio Allegato e Cc (copia in carbonio).
Anche se l'oggetto Record e la riga corrente del Recordset hanno gli stessi campi, sono diversi perché i Record e gli oggetti Recordset hanno metodi e proprietà diversi.
Un campo contenuto in comune dai Record e dal Recordset può essere modificato su 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 del 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 alla Record dipendono dal provider sottostante. Attualmente, la maggior parte dei provider aggiunge un set di campi che descrivono l'entità rappresentata dall'Record. Se l'entità è costituita da un flusso di byte, ad esempio un file semplice, un oggetto Stream può essere in genere aperto dal Record.
Campi speciali per i fornitori di sorgente dei documenti
Una classe speciale di provider, denominati provider di origine di 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 del documento 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 al stream che rappresenta il documento.
Questi campi costituiscono una risorsa record o recordset e sono elencati per i provider specifici che li supportano in Appendice A: Provider.
Due costanti indicizzano la collezione Fields di una risorsa Record o Recordset per recuperare una coppia di campi comunemente utilizzati. La proprietà Field oggetto Value restituisce il contenuto desiderato.
Il campo a cui si accede con la costante adDefaultStream contiene un flusso predefinito associato all'oggetto Record o all'oggetto 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 fornitore di origine del documento non supporta la raccolta delle proprietà degli oggetti Record e Field. Il contenuto dell'insieme Properties è Null per tali oggetti.
Un provider di origini documenti può aggiungere una proprietà specifica del provider, ad esempio Tipo di origine dati, per identificare se sia un provider di origini documenti. Per altre informazioni su come determinare il tipo di provider, vedere la documentazione del provider.
Colonne dell'insieme di record delle risorse
Un recordset di risorse è costituito dalle colonne seguenti.
| Nome colonna | Digitare | 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 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 una memoria legale. Questo può corrispondere al modello di Office usato per creare il documento. |
| RESOURCE_CONTENTCLASS | AdVarWChar | Indica il tipo MIME del documento, che indica il formato , ad esempio "text/html". |
| RESOURCE_CONTENTLANGUAGE | AdVarWChar | Indica la lingua in cui è archiviato il contenuto. |
| CREAZIONE_RISORSA_TEMPO | adFileTime | Sola lettura. Indica una struttura FILETIME che contiene l'ora di creazione della risorsa. L'ora viene segnalata 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. |
| ULTIMA_MODIFICA_RISORSA | AdFileTime | Sola lettura. Indica una struttura FILETIME contenente 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 | comeInteroNonFirmato | Sola lettura. Indica le dimensioni del flusso predefinito della risorsa, in byte. |
| RISORSA_ÈCOLLEZIONE | AdBoolean | Sola lettura. Vero se la risorsa è una raccolta, come ad esempio una directory. False se la risorsa è un file semplice. |
| RISORSA_ÈDOCUMENTOSTRUTTURATO | AdBoolean | True se la risorsa è un documento strutturato. False se la risorsa non è un documento strutturato. Potrebbe trattarsi di una raccolta o di un file semplice. |
| DOCUMENTO_PREDEFINITO | AdVarWChar | Sola lettura. Indica che questa risorsa contiene un URL per il documento semplice predefinito di una cartella o di un documento strutturato. Usato quando il flusso predefinito viene richiesto da una risorsa. Questa proprietà è vuota per un file semplice. |
| BAMBINI_CAPITOLATI | AdChapter | Sola lettura. Opzionale. Indica il capitolo del rowset che contiene gli elementi figli della risorsa. Il provider OLE DB per internet Publishing non utilizza 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. |