Classe di CRecordset

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

class CRecordset : public CObject

Membri

92bcy0kw.collapse_all(it-it,VS.110).gifCostruttori pubblici

Nome

Descrizione

CRecordset::CRecordset

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

92bcy0kw.collapse_all(it-it,VS.110).gifMetodi 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.

92bcy0kw.collapse_all(it-it,VS.110).gifMembri 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.

Gerarchia di ereditarietà

CObject

CRecordset

Requisiti

Header: afxdb.h

Vedere anche

Riferimenti

Classe di CObject

Grafico della gerarchia

Classe CDatabase

Classe di CRecordView