Classe CDaoRecordset

Articolo
06/10/2015

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

class CDaoRecordset : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CDaoRecordset::CDaoRecordset	Costruisce un oggetto CDaoRecordset.

Metodi pubblici

Nome	Descrizione
CDaoRecordset::AddNew	Prepara per l'aggiunta di un nuovo record. Chiamata Aggiorna per completare l'aggiunta.
CDaoRecordset::CanAppend	Restituisce diverso da zero se i nuovi record possono essere aggiunti al recordset mediante la funzione membro AddNew.
CDaoRecordset::CanBookmark	Restituisce diverso da zero se il recordset supporta i segnalibri.
CDaoRecordset::CancelUpdate	Annulla tutti gli aggiornamenti in corso a causa di un'operazione AddNew o Modifica.
CDaoRecordset::CanRestart	Restituisce diverso da zero se Ripetere una query può essere chiamato per eseguire nuovamente la query del recordset.
CDaoRecordset::CanScroll	Restituisce diverso da zero se è possibile scorrere i record.
CDaoRecordset::CanTransact	Restituisce diverso da zero se l'origine dati supporta le transazioni.
CDaoRecordset::CanUpdate	Restituisce diverso da zero se il recordset è possibile aggiornare (è possibile aggiungere, aggiornare, o eliminare record).
CDaoRecordset::Close	Chiude il recordset.
CDaoRecordset::Delete	Elimina il record corrente dal recordset. Impostare in modo esplicito passare a un altro record dopo l'eliminazione.
CDaoRecordset::DoFieldExchange	Chiamato per scambiare dati in entrambe le direzioni) tra i membri dati di campo del recordset e il record corrispondente nell'origine dati. Trasferimento di campi di record DAO di risorse (DFX).
CDaoRecordset::Edit	Prepara per le modifiche al record corrente. Chiamata Aggiorna per completare la modifica.
CDaoRecordset::FillCache	Il controllo occupa tutto o parte cache locale per un oggetto recordset contenente i dati da un'origine dati ODBC.
CDaoRecordset::Find	Individuare la prima, il percorso seguente, precedente, oppure l'ultima di una particolare stringa in un recordset di tipo dynaset che soddisfa i criteri specificati e fatto che registra il record corrente.
CDaoRecordset::FindFirst	Individuare il primo record in un recordset di tipo dynaset o di tipo snapshot che soddisfa i criteri specificati e fatto che registra il record corrente.
CDaoRecordset::FindLast	Individuare l'ultimo record in un recordset di tipo dynaset o di tipo snapshot che soddisfa i criteri specificati e fatto che registra il record corrente.
CDaoRecordset::FindNext	Individuare il record successivo in un recordset di tipo dynaset o di tipo snapshot che soddisfa i criteri specificati e fatto che registra il record corrente.
CDaoRecordset::FindPrev	Individuare il record precedente in un recordset di tipo dynaset o di tipo snapshot che soddisfa i criteri specificati e fatto che registra il record corrente.
CDaoRecordset::GetAbsolutePosition	Restituisce il numero di record del record corrente di un oggetto recordset.
CDaoRecordset::GetBookmark	Restituisce un valore che rappresenta il segnalibro su un record.
CDaoRecordset::GetCacheSize	Restituisce un valore che specifica il numero di record in un recordset di tipo dynaset contenente i dati in locale da memorizzare nella cache da un'origine dati ODBC.
CDaoRecordset::GetCacheStart	Restituisce un valore che specifica il segnalibro del primo record del recordset da memorizzare nella cache.
CDaoRecordset::GetCurrentIndex	Restituisce CString contenente il nome dell'indice utilizzato più di recente in CDaoRecordsetindicizzato e di tipo tabella.
CDaoRecordset::GetDateCreated	Restituisce la data e l'ora nella tabella di base sottostante a un oggetto CDaoRecordset è stata creata
CDaoRecordset::GetDateLastUpdated	Restituisce la data e ora di modifica più recente effettuata alla progettazione di una tabella di base sottostante a un oggetto CDaoRecordset.
CDaoRecordset::GetDefaultDBName	Restituisce il nome dell'origine dati predefiniti.
CDaoRecordset::GetDefaultSQL	Chiamato per ottenere la stringa SQL predefinita a eseguire.
CDaoRecordset::GetEditMode	Restituisce un valore che indica lo stato della modifica del record corrente.
CDaoRecordset::GetFieldCount	Restituisce un valore che rappresenta il numero di campi in un recordset.
CDaoRecordset::GetFieldInfo	Restituisce tipi specifici di informazioni sui campi del recordset.
CDaoRecordset::GetFieldValue	Restituisce il valore di un campo di un recordset.
CDaoRecordset::GetIndexCount	Recupera il numero di indici in una tabella sottostante a un recordset.
CDaoRecordset::GetIndexInfo	Restituisce i vari tipi di informazioni su un indice.
CDaoRecordset::GetLastModifiedBookmark	Utilizzato per determinare il record aggiunti di recente o aggiornato.
CDaoRecordset::GetLockingMode	Restituisce un valore che indica il tipo di blocco viene applicata durante la modifica.
CDaoRecordset::GetName	Restituisce CString contenente il nome del recordset.
CDaoRecordset::GetParamValue	Recupera il valore corrente del parametro specificato archiviato nell'oggetto sottostante di DAOParameter.
CDaoRecordset::GetPercentPosition	Restituisce la posizione del record corrente come percentuale del numero totale di record.
CDaoRecordset::GetRecordCount	Restituisce il numero di record eseguito in un oggetto recordset.
CDaoRecordset::GetSQL	Ottiene la stringa SQL utilizzata per selezionare i record del recordset.
CDaoRecordset::GetType	Chiamato per determinare il tipo di recordset: tipo di tabella, di tipo dynaset, o tipo snapshot.
CDaoRecordset::GetValidationRule	Restituisce CString contenente il valore da convalidare i dati quando viene inserito in un campo.
CDaoRecordset::GetValidationText	Recupera il testo visualizzato quando una regola di convalida non viene soddisfatta.
CDaoRecordset::IsBOF	Restituisce diverso da zero se il recordset è stato inserito prima del primo record. Non è disponibile alcun record corrente.
CDaoRecordset::IsDeleted	Restituisce diverso da zero se il recordset è posizionato su un record eliminato.
CDaoRecordset::IsEOF	Restituisce diverso da zero se il recordset è stato posizionato dopo l'ultimo record. Non è disponibile alcun record corrente.
CDaoRecordset::IsFieldDirty	Restituisce diverso da zero se il campo specificato nel record corrente è stato modificato.
CDaoRecordset::IsFieldNull	Restituisce diverso da zero se il campo specificato nel record corrente è null (non avendo valore).
CDaoRecordset::IsFieldNullable	Restituisce diverso da zero se il campo specificato nel record corrente può essere impostato su null (non avendo valore).
CDaoRecordset::IsOpen	Restituisce diverso da zero se Apri è stata chiamata in precedenza.
CDaoRecordset::Move	Posiziona il recordset su un determinato numero di record dal record corrente in entrambe le direzioni.
CDaoRecordset::MoveFirst	Posizionare il record corrente nel primo record del recordset.
CDaoRecordset::MoveLast	Posizionare il record corrente nell'ultimo record del recordset.
CDaoRecordset::MoveNext	Posizionare il record corrente nel record successivo nel recordset.
CDaoRecordset::MovePrev	Posizionare il record corrente nel record precedente nel recordset.
CDaoRecordset::Open	Crea un nuovo recordset da una tabella, da un dynaset, uno snapshot.
CDaoRecordset::Requery	Esegue nuovamente la query del recordset per aggiornare i record selezionati.
CDaoRecordset::Seek	Individuare il record in un oggetto indicizzato di recordset di tipo tabella che soddisfa i criteri specificati per l'indice corrente e fatto che registra il record corrente.
CDaoRecordset::SetAbsolutePosition	Imposta il numero di record del record corrente di un oggetto recordset.
CDaoRecordset::SetBookmark	Posizionare il recordset su un record contenente il segnalibro specificato.
CDaoRecordset::SetCacheSize	Imposta un valore che specifica il numero di record in un recordset di tipo dynaset contenente i dati in locale da memorizzare nella cache da un'origine dati ODBC.
CDaoRecordset::SetCacheStart	Imposta un valore che specifica il segnalibro del primo record del recordset da memorizzare nella cache.
CDaoRecordset::SetCurrentIndex	Chiamato per impostare un indice in un recordset di tipo tabella.
CDaoRecordset::SetFieldDirty	Contrassegna il campo specificato nel record corrente come modificato.
CDaoRecordset::SetFieldNull	Imposta il valore del campo specificato nel record corrente per annullare (non avendo valore).
CDaoRecordset::SetFieldValue	Imposta il valore di un campo di un recordset.
CDaoRecordset::SetFieldValueNull	Imposta il valore di un campo di un recordset per annullare. (non avendo valore).
CDaoRecordset::SetLockingMode	Imposta un valore che indica il tipo di blocco per attuare durante la modifica.
CDaoRecordset::SetParamValue	Imposta il valore corrente del parametro specificato archiviato nell'oggetto sottostante di DAOParameter
CDaoRecordset::SetParamValueNull	Imposta il valore corrente del parametro specificato per annullare (non avendo valore).
CDaoRecordset::SetPercentPosition	Imposta la posizione del record corrente a una posizione corrispondente a una percentuale del numero totale di record in un recordset.
CDaoRecordset::Update	Completa un'operazione Modifica o AddNew salvare i dati nuovi o modificati nell'origine dati.

Membri dati pubblici

Nome	Descrizione
CDaoRecordset::m_bCheckCacheForDirtyFields	Contiene un flag che indica se i campi automaticamente sono contrassegnati come modificati.
CDaoRecordset::m_nFields	Contiene il numero dei membri dati di campo nella classe recordset e il numero di colonne selezionate dal recordset dall'origine dati.
CDaoRecordset::m_nParams	Contiene il numero dei membri dati di parametro nella classe recordset al numero dei parametri passati alla query del recordset
CDaoRecordset::m_pDAORecordset	Un puntatore a un'interfaccia di DAO sottostante all'oggetto recordset.
CDaoRecordset::m_pDatabase	Database di origine per questo gruppo di risultati. Contiene un puntatore a un oggetto CDaoDatabase.
CDaoRecordset::m_strFilter	Contiene una stringa utilizzata per creare un'istruzione SQL where.
CDaoRecordset::m_strSort	Contiene una stringa utilizzata per creare un'istruzione SQL ORDER BY.

Note

Noto come "recordset", gli oggetti CDaoRecordset sono disponibili nei seguenti tre modi:

I recordset di tipo tabella rappresentano una tabella di base che è possibile utilizzare per esaminare, aggiungere, modificare, o eliminare i record da una tabella di database.
I recordset di tipo dynaset sono il risultato di una query che può contenere record aggiornato. Questi recordset sono un insieme di record che è possibile utilizzare per esaminare, aggiungere, modificare, o eliminare i record da una tabella di database o dalle tabelle sottostante. I recordset di tipo dynaset possono contenere i campi da una o più tabelle di un database.
I recordset di tipo snapshot sono una copia statica di un insieme di record che è possibile utilizzare per individuare i dati o generare rapporti. Questi recordset possono contenere i campi da una o più tabelle di un database ma non possono essere aggiornati.

Ogni form del recordset rappresenta un insieme di record corretto quando si apre il recordset. Quando si scorre un record in un recordset di tipo tabella o in un recordset di tipo dynaset, riflette le modifiche apportate al record dopo che il recordset viene aperto, da altri utenti o da altri recordset nell'applicazione. (Il recordset di tipo snapshot di un oggetto non può essere aggiornato.) È possibile utilizzare direttamente CDaoRecordset o derivare una classe specifica dell'applicazione di recordset da CDaoRecordset. Sarà quindi possibile:

Scorrimento dei record.
Impostare un indice e individuare rapidamente i record mediante ricerca (recordset di tipo tabella solo).
Individuare i record in base a un confronto di stringhe: "<", "<=", "=", ">=", o ">" (recordset di tipo dynaset e di tipo snapshot).
Aggiornare i record e specificare la modalità di blocco (eccetto i recordset di tipo snapshot).
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.

La classe fornisce i CDaoRecordset di un'interfaccia simile a quella della classe CRecordset. La differenza principale è che la classe CDaoRecordset accede ai dati tramite un oggetto di accesso ai dati (DAO) basato su OLE. La classe CRecordset accede al DBMS con ODBC (open database connectivity) e un driver ODBC per il DBMS.

Nota

Le classi di database DAO sono differenziate dalle classi di database MFC basate su ODBC.Tutti i nomi delle classi di database DAO dispongono del prefisso "di CDao".È ancora possibile accedere alle origini dati ODBC con le classi DAO, le classi DAO presentano in genere le funzionalità principali perché sono specifiche del modulo di gestione di database Microsoft Jet.

È possibile utilizzare direttamente CDaoRecordset o derivare la classe da CDaoRecordset. Per utilizzare una classe di recordset in entrambi i casi, aprire un database e creare un oggetto recordset, passando al costruttore un puntatore all'oggetto CDaoDatabase. È inoltre possibile costruire un oggetto CDaoRecordset e si lascia MFC creare un oggetto temporaneo CDaoDatabase automaticamente. Chiamare la funzione membro Apri del recordset, che specifica se l'oggetto è un recordset di tipo tabella, un recordset di tipo dynaset, o un recordset di tipo snapshot. Chiamare Apri selezionare i dati dal database e recupera il primo record.

Utilizzare le funzioni membro e i membri dati dell'oggetto scorrere i record e funzionili su. Le operazioni disponibili dipendono da se l'oggetto è un recordset di tipo tabella, un recordset di tipo dynaset, o un recordset di tipo snapshot e se è aggiornabile o in sola lettura a questo dipende dalla funzionalità di database o di un'origine dati ODBC (open database connectivity). Per aggiornare i record che possono essere modificati o aggiungere poiché la chiamata Apri, chiama la funzione membro Ripetere una query dell'oggetto. Chiamare la funzione membro Chiudi dell'oggetto ed eliminare l'oggetto dopo aver utilizzato.

CDaoRecordset utilizza il trasferimento di campi di record DAO (DFX) per supportare la lettura e aggiornare i campi del record mediante membri indipendenti dai tipi C++ del CDaoRecordset o CDaoRecordsetclasse derivata da. È inoltre possibile applicare il collegamento dinamico delle colonne in un database senza utilizzare il meccanismo di DFX utilizzando GetFieldValue e SetFieldValue.

Per informazioni correlate, vedere l'argomento "oggetto recordset" nella Guida di DAO.