Oggetto Record (ADO)

Rappresenta una riga di un oggetto Recordset o del provider di dati o di un oggetto restituito da un provider di dati semistrutturato, ad esempio un file o una directory.

Osservazioni

Un oggetto Record rappresenta una riga di dati e presenta alcune somiglianze concettuali con un oggetto Recordset a una riga. A seconda delle funzionalità del provider, gli oggetti Record possono essere restituiti direttamente dal provider anziché da un oggetto Recordset a una riga, ad esempio quando viene eseguita una query SQL che seleziona una sola riga. In alternativa, è possibile ottenere un oggetto Record direttamente da un oggetto Recordset. In alternativa, un oggetto record può essere restituito direttamente da un provider a dati semistrutturati, ad esempio il provider OLE DB di Microsoft Exchange.

È possibile visualizzare i campi associati all'oggetto Record tramite la raccolta Fields nell'oggetto Record. ADO consente colonne con valori oggetto, tra cui Recordset, SafeArray e valori scalari nella raccolta Fields di oggetti Record.

Se l'oggetto Record rappresenta una riga in un oggetto Recordset, è possibile tornare a tale oggetto Recordset originale con la proprietà Source.

L'oggetto Record può essere usato anche da provider di dati semistrutturati, ad esempio il provider Microsoft OLE DB per Internet Publishing, per modellare gli spazi dei nomi strutturati ad albero. Ogni nodo nell'albero è un oggetto Record con colonne associate. Le colonne possono rappresentare gli attributi di tale nodo e altre informazioni pertinenti. L'oggetto Record può rappresentare sia un nodo foglia che un nodo non foglia nella struttura ad albero. I nodi non foglia contengono altri nodi, a differenza dei nodi foglia. I nodi foglia in genere contengono flussi binari di dati, mentre ai nodi non foglia può essere associato anche un flusso binario predefinito. Le proprietà nell'oggetto Record identificano il tipo di nodo.

L'oggetto Record rappresenta anche un modo alternativo per esplorare i dati gerarchicamente organizzati. È possibile creare un oggetto Record per rappresentare la radice di un sotto albero specifico in una struttura ad albero di grandi dimensioni e aprire nuovi oggetti Record per rappresentare nodi figlio.

Una risorsa, ad esempio un file o una directory, può essere identificata in modo univoco da un URL assoluto. Un oggetto Connection viene creato e impostato in modo implicito sull'oggetto Record quando l'oggetto Record viene aperto usando un URL assoluto. Un oggetto Connection può essere impostato in modo esplicito sull'oggetto Record tramite la proprietà ActiveConnection. I file e le directory a cui è possibile accedere usando l'oggetto Connection definiscono il contesto in cui possono essere eseguite operazioni su Record.

I metodi di modifica e spostamento dei dati nell'oggetto Record accettano come punto di partenza anche un URL relativo, che individua una risorsa usando un URL assoluto o il contesto dell'oggetto Connection.

Nota

Gli URL che usano lo schema http richiamano automaticamente il provider Microsoft OLE DB per Internet Publishing. Per altre informazioni, vedere URL assoluti e relativi.

A ogni oggetto Record è associato un oggetto Connection. Pertanto, è possibile includere in una transazione le operazioni su oggetti Record richiamando i metodi di transazione dell'oggetto Connection.

L'oggetto Record non supporta gli eventi ADO e pertanto non risponderà alle notifiche.

Con i metodi e le proprietà di un oggetto Record è possibile eseguire le operazioni seguenti:

  • Impostare o restituire l'oggetto Connection associato con la proprietà ActiveConnection.

  • Indicare le autorizzazioni di accesso con la proprietà Mode.

  • Restituire l'URL della directory, se presente, che contiene la risorsa rappresentata dalla proprietà Record con la proprietà ParentURL.

  • Indicare l'URL assoluto, l'URL relativo o l'oggetto Recordset da cui viene derivato l'oggetto Record con la proprietà Source.

  • Indicare lo stato corrente dell'oggetto Record con la proprietà State.

  • Indicare il tipo di oggetto Record, ovvero semplice, raccolta o documento strutturato, con la proprietà RecordType.

  • Arrestare l'esecuzione di un'operazione asincrona con il metodo Cancel.

  • Disassociare l'oggetto Record da un'origine dati con il metodo Close.

  • Copiare il file o la directory rappresentata da un oggetto Record in un altro percorso con il metodo CopyRecord.

  • Eliminare il file o la directory e le sottodirectory rappresentate da un oggetto Record con il metodo DeleteRecord.

  • Aprire un oggetto Recordset contenente righe che rappresentano le sottodirectory e i file dell'entità rappresentata dall'oggetto Record con il metodo GetChildren.

  • Spostare (rinominare) il file o la directory e le sottodirectory rappresentate da un oggetto Record in un altro percorso con il metodo MoveRecord.

  • Associare l'oggetto Record a un'origine dati esistente oppure creare un nuovo file o una nuova directory con il metodo Open.

L'oggetto Record è sicuro per lo scripting.

In questa sezione viene trattato l'argomento seguente.

Vedere anche

Raccolta Fields (ADO)
Raccolta Properties (ADO)
Record e flussi
Oggetto Recordset (ADO)