Classe CRecordset

Articolo
06/10/2015

Rappresenta un insieme di record selezionato da un'origine dati.

class CRecordset : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CRecordset::CRecordset	Costruisce un oggetto CRecordset. La classe derivata deve fornire un costruttore che chiama questo.

Metodi pubblici

Nome	Descrizione
CRecordset::AddNew	Prepara per l'aggiunta di un nuovo record. Chiamata Update per completare l'aggiunta.
CRecordset::CanAppend	Restituisce diverso da zero se i nuovi record possono essere aggiunti al recordset mediante la funzione membro AddNew.
CRecordset::CanBookmark	Restituisce diverso da zero se il recordset supporta i segnalibri.
CRecordset::Cancel	Annulla un'operazione asincrona o un processo da un secondo thread.
CRecordset::CancelUpdate	Annulla tutti gli aggiornamenti in corso a causa di un'operazione Edit o AddNew.
CRecordset::CanRestart	Restituisce diverso da zero se Requery può essere chiamato per eseguire nuovamente la query del recordset.
CRecordset::CanScroll	Restituisce diverso da zero se è possibile scorrere i record.
CRecordset::CanTransact	Restituisce diverso da zero se l'origine dati supporta le transazioni.
CRecordset::CanUpdate	Restituisce diverso da zero se il recordset è possibile aggiornare (è possibile aggiungere, aggiornare, o eliminare record).
CRecordset::CheckRowsetError	Chiamato per gestire gli errori generati durante il recupero record.
CRecordset::Close	Chiude il recordset e ODBC HSTMT associato.
CRecordset::Delete	Elimina il record corrente dal recordset. Impostare in modo esplicito passare a un altro record dopo l'eliminazione.
CRecordset::DoBulkFieldExchange	Chiamato per lo scambio di massa di righe di dati da un'origine dati al recordset. Bulk Record Field Exchange di risorse (RFX di massa.
CRecordset::DoFieldExchange	Chiamato per scambiare dati in entrambe le direzioni) tra i membri dati di campo del recordset e il record corrispondente nell'origine dati. Implementa trasferimento di campi di Record.
CRecordset::Edit	Prepara per le modifiche al record corrente. Chiamata Update per completare la modifica.
CRecordset::FlushResultSet	Restituisce diverso da zero se esiste un altro gruppo di risultati da recuperare quando si utilizza una query già definita.
CRecordset::GetBookmark	Assegna il valore del segnalibro di un record all'oggetto parametro.
CRecordset::GetDefaultConnect	Chiamato per ottenere la stringa di connessione predefinito.
CRecordset::GetDefaultSQL	Chiamato per ottenere la stringa SQL predefinita a eseguire.
CRecordset::GetFieldValue	Restituisce il valore di un campo di un recordset.
CRecordset::GetODBCFieldCount	Restituisce il numero di campi del recordset.
CRecordset::GetODBCFieldInfo	Restituisce tipi specifici di informazioni sui campi in un recordset.
CRecordset::GetRecordCount	Restituisce il numero di record del recordset.
CRecordset::GetRowsetSize	Restituisce il numero di record che si desidera recuperare durante la sola raccolta.
CRecordset::GetRowsFetched	Restituisce il numero di righe recuperate durante la raccolta.
CRecordset::GetRowStatus	Restituisce lo stato della riga dopo una raccolta.
CRecordset::GetSQL	Ottiene la stringa SQL utilizzata per selezionare i record del recordset.
CRecordset::GetStatus	Ottiene lo stato del recordset: indice del record corrente e se un conteggio finale dei record è stato ottenuto.
CRecordset::GetTableName	Ottiene il nome della tabella in cui il recordset basato.
CRecordset::IsBOF	Restituisce diverso da zero se il recordset è stato inserito prima del primo record. Non è disponibile alcun record corrente.
CRecordset::IsDeleted	Restituisce diverso da zero se il recordset è posizionato su un record eliminato.
CRecordset::IsEOF	Restituisce diverso da zero se il recordset è stato posizionato dopo l'ultimo record. Non è disponibile alcun record corrente.
CRecordset::IsFieldDirty	Restituisce diverso da zero se il campo specificato nel record corrente è stato modificato.
CRecordset::IsFieldNull	Restituisce diverso da zero se il campo specificato nel record corrente è null (non ha valore).
CRecordset::IsFieldNullable	Restituisce diverso da zero se il campo specificato nel record corrente può essere impostato su null (non avendo valore).
CRecordset::IsOpen	Restituisce diverso da zero se Open è stata chiamata in precedenza.
CRecordset::Move	Posiziona il recordset su un determinato numero di record dal record corrente in entrambe le direzioni.
CRecordset::MoveFirst	Posizionare il record corrente nel primo record del recordset. Test per IsBOF per primo.
CRecordset::MoveLast	Posizionare il record corrente nell'ultimo record oultimo rowset. Test per IsEOF per primo.
CRecordset::MoveNext	Posizionare il record corrente nel record successivo o sul rowset successivo. Test per IsEOF per primo.
CRecordset::MovePrev	Posizionare il record corrente nel record precedente o sul rowset precedente. Test per IsBOF per primo.
CRecordset::OnSetOptions	Chiamato per impostare opzioni (utilizzato nella selezione) per l'istruzione specificato ODBC.
CRecordset::OnSetUpdateOptions	Chiamato per impostare opzioni (utilizzate sull'aggiornamento) per l'istruzione specificato ODBC.
CRecordset::Open	Apre il recordset recuperando la tabella o esegue la query del recordset rappresenta.
CRecordset::RefreshRowset	Aggiorna i dati e lo stato delle righe specificate.
CRecordset::Requery	Esegue nuovamente la query del recordset per aggiornare i record selezionati.
CRecordset::SetAbsolutePosition	Posizionare il recordset nel record corrispondente al numero di record specificato.
CRecordset::SetBookmark	Posizionare il recordset sul record specificato dal segnalibro.
CRecordset::SetFieldDirty	Contrassegna il campo specificato nel record corrente come modificato.
CRecordset::SetFieldNull	Imposta il valore del campo specificato nel record corrente per annullare (non avendo valore).
CRecordset::SetLockingMode	Imposta blocco ottimistico "di" modalità di blocco (impostazione predefinita) o "blocco pessimistico". Determina quali record sono bloccati per gli aggiornamenti.
CRecordset::SetParamNull	Imposta il parametro specificato per annullare (non avendo valore).
CRecordset::SetRowsetCursorPosition	Posizionare il cursore sulla riga specificata nel rowset.
CRecordset::SetRowsetSize	Specifica il numero di record che si desidera recuperare durante la raccolta.
CRecordset::Update	Completa un'operazione Edit o AddNew salvare i dati nuovi o modificati nell'origine dati.

Membri dati pubblici

Nome	Descrizione
CRecordset::m_hstmt	Contiene l'handle di un'istruzione ODBC per il recordset. Digitare HSTMT.
CRecordset::m_nFields	Contiene il numero dei membri dati di campo del recordset. Digitare UINT.
CRecordset::m_nParams	Contiene il numero dei membri dati di parametro nel recordset. Digitare UINT.
CRecordset::m_pDatabase	Contiene un puntatore all'oggetto CDatabase in cui il recordset è connesso a un'origine dati.
CRecordset::m_strFilter	Contiene CString che specifica una clausola WHERE (SQL) SQL. Utilizzato come un filtro per selezionare solo i record che soddisfano determinati criteri.
CRecordset::m_strSort	Contiene CString che specifica una clausola SQL ORDER BY. Utilizzato per controllare quali record vengono ordinati.

Note

Noto come "recordset", gli oggetti CRecordset in genere utilizzati in due formati: dynaset e snapshot. Un dynaset restano sincronizzati con gli aggiornamenti dei dati apportate da altri utenti. Uno snapshot è una visualizzazione statica dei dati. Ogni form rappresenta un insieme di record corretto quando si apre il recordset, ma quando si scorre un record in un dynaset, riflette le modifiche apportate successivamente al record, da altri utenti o da altri recordset nell'applicazione.

Nota

Se si utilizzano gli oggetti di accesso ai dati che (DAO) classi anziché le classi ODBC (open database connectivity), la classe CDaoRecordset di utilizzare.Per ulteriori informazioni, vedere l'articolo cenni preliminari: La programmazione di database.

Per utilizzare qualsiasi tipo di recordset, in genere deriva una classe specifica dell'applicazione di recordset da CRecordset. I recordset selezionano record da un'origine dati e quindi:

Scorrimento dei record.
Aggiornare i record e specificare la modalità di blocco.
Filtrare il recordset per limitare i record sceglie da quelli disponibili nell'origine dati.
Ordinare il recordset.
Parametri al recordset per personalizzare la selezione con informazioni non note fino al runtime.

Per utilizzare la classe, aprire un database e creare un oggetto recordset, passando al costruttore un puntatore all'oggetto CDatabase. Chiamare la funzione membro Apri del recordset, dove è possibile specificare se l'oggetto è un dynaset o uno snapshot. Chiamare Apri selezionare i dati da un'origine dati. Dopo che l'oggetto recordset viene aperto, utilizzare le funzioni membro e i membri dati per scorrere i record e per funzionarli su. Le operazioni disponibili dipendono da se l'oggetto è un dynaset o uno snapshot, se è aggiornabile o di sola lettura (questo dipende dalla funzionalità dell'origine dati ODBC (open database connectivity) e se si è implementato il recupero di massa di righe. Per aggiornare i record che possono essere modificati o aggiungere poiché la chiamata Apri, chiama la funzione membro Requery dell'oggetto. Chiamare la funzione membro Chiudi dell'oggetto ed eliminare l'oggetto dopo aver utilizzato.

In una classe derivata CRecordset, trasferimento di campi di Record o il l'rfx di massa) viene utilizzato per supportare la lettura e aggiornare i campi del record.

Per ulteriori informazioni sui recordset e su Record Field Exchange, vedere gli articoli cenni preliminari: La programmazione di database, recordset (ODBC), recordset: Recupero di massa di record (ODBC)e Trasferimento di campi di Record. Per lo stato attivo sui dynaset e sugli snapshot, vedere gli articoli dynaset e snapshot.