Classe di CRecordset
Rappresenta un insieme di record selezionato da un'origine dati.
class CRecordset : public CObject
Membri
Costruttori pubblici
Nome |
Descrizione |
---|---|
Costruisce un oggetto CRecordset.La classe derivata deve fornire un costruttore che chiama questo. |
Metodi pubblici
Nome |
Descrizione |
---|---|
Prepara per l'aggiunta di un nuovo record.Chiamata Update per completare l'aggiunta. |
|
Restituisce diverso da zero se i nuovi record possono essere aggiunti al recordset mediante la funzione membro AddNew. |
|
Restituisce diverso da zero se il recordset supporta i segnalibri. |
|
Annulla un'operazione asincrona o un processo da un secondo thread. |
|
Annulla tutti gli aggiornamenti in corso a causa di un'operazione Edit o AddNew. |
|
Restituisce diverso da zero se Requery può essere chiamato per eseguire nuovamente la query del recordset. |
|
Restituisce diverso da zero se è possibile scorrere i record. |
|
Restituisce diverso da zero se l'origine dati supporta le transazioni. |
|
Restituisce diverso da zero se il recordset è possibile aggiornare (è possibile aggiungere, aggiornare, o eliminare record). |
|
Chiamato per gestire gli errori generati durante il recupero record. |
|
Chiude il recordset e ODBC HSTMT associato. |
|
Elimina il record corrente dal recordset.Impostare in modo esplicito passare a un altro record dopo l'eliminazione. |
|
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. |
|
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. |
|
Prepara per le modifiche al record corrente.Chiamata Update per completare la modifica. |
|
Restituisce diverso da zero se esiste un altro gruppo di risultati da recuperare quando si utilizza una query già definita. |
|
Assegna il valore del segnalibro di un record all'oggetto parametro. |
|
Chiamato per ottenere la stringa di connessione predefinito. |
|
Chiamato per ottenere la stringa SQL predefinita a eseguire. |
|
Restituisce il valore di un campo di un recordset. |
|
Restituisce il numero di campi del recordset. |
|
Restituisce tipi specifici di informazioni sui campi in un recordset. |
|
Restituisce il numero di record del recordset. |
|
Restituisce il numero di record che si desidera recuperare durante la sola raccolta. |
|
Restituisce il numero di righe recuperate durante la raccolta. |
|
Restituisce lo stato della riga dopo una raccolta. |
|
Ottiene la stringa SQL utilizzata per selezionare i record del recordset. |
|
Ottiene lo stato del recordset: indice del record corrente e se un conteggio finale dei record è stato ottenuto. |
|
Ottiene il nome della tabella in cui il recordset basato. |
|
Restituisce diverso da zero se il recordset è stato inserito prima del primo record.Non è disponibile alcun record corrente. |
|
Restituisce diverso da zero se il recordset è posizionato su un record eliminato. |
|
Restituisce diverso da zero se il recordset è stato posizionato dopo l'ultimo record.Non è disponibile alcun record corrente. |
|
Restituisce diverso da zero se il campo specificato nel record corrente è stato modificato. |
|
Restituisce diverso da zero se il campo specificato nel record corrente è null (non ha valore). |
|
Restituisce diverso da zero se il campo specificato nel record corrente può essere impostato su null (non avendo valore). |
|
Restituisce diverso da zero se Open è stata chiamata in precedenza. |
|
Posiziona il recordset su un determinato numero di record dal record corrente in entrambe le direzioni. |
|
Posizionare il record corrente nel primo record del recordset.Test per IsBOF per primo. |
|
Posizionare il record corrente nell'ultimo record oultimo rowset.Test per IsEOF per primo. |
|
Posizionare il record corrente nel record successivo o sul rowset successivo.Test per IsEOF per primo. |
|
Posizionare il record corrente nel record precedente o sul rowset precedente.Test per IsBOF per primo. |
|
Chiamato per impostare opzioni (utilizzato nella selezione) per l'istruzione specificato ODBC. |
|
Chiamato per impostare opzioni (utilizzate sull'aggiornamento) per l'istruzione specificato ODBC. |
|
Apre il recordset recuperando la tabella o esegue la query del recordset rappresenta. |
|
Aggiorna i dati e lo stato delle righe specificate. |
|
Esegue nuovamente la query del recordset per aggiornare i record selezionati. |
|
Posizionare il recordset nel record corrispondente al numero di record specificato. |
|
Posizionare il recordset sul record specificato dal segnalibro. |
|
Contrassegna il campo specificato nel record corrente come modificato. |
|
Imposta il valore del campo specificato nel record corrente per annullare (non avendo valore). |
|
Imposta blocco ottimistico "di" modalità di blocco (impostazione predefinita) o "blocco pessimistico".Determina quali record sono bloccati per gli aggiornamenti. |
|
Imposta il parametro specificato per annullare (non avendo valore). |
|
Posizionare il cursore sulla riga specificata nel rowset. |
|
Specifica il numero di record che si desidera recuperare durante la raccolta. |
|
Completa un'operazione Edit o AddNew salvare i dati nuovi o modificati nell'origine dati. |
Membri dati pubblici
Nome |
Descrizione |
---|---|
Contiene l'handle di un'istruzione ODBC per il recordset.Digitare HSTMT. |
|
Contiene il numero dei membri dati di campo del recordset.Digitare UINT. |
|
Contiene il numero dei membri dati di parametro nel recordset.Digitare UINT. |
|
Contiene un puntatore all'oggetto CDatabase in cui il recordset è connesso a un'origine dati. |
|
Contiene CString che specifica una clausola WHERE (SQL) SQL.Utilizzato come un filtro per selezionare solo i record che soddisfano determinati criteri. |
|
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.
Gerarchia di ereditarietà
CRecordset
Requisiti
Header: afxdb.h