Recordset: applicazione di parametri a un recordset (ODBC)

Articolo
09/12/2008

Aggiornamento: novembre 2007

L'argomento è relativo alle classi ODBC MFC.

Qualora si desideri selezionare i record in fase di esecuzione utilizzando informazioni calcolate o specificate dall'utente finale, è possibile utilizzare i parametri del recordset.

In questo argomento vengono fornite informazioni su:

Recordset con parametri.
Utilizzo dei parametri.
Applicazione di parametri alla classe del recordset.
Passaggio dei valori dei parametri in fase di esecuzione.

Recordset con parametri

È possibile passare informazioni sui parametri in fase di esecuzione mediante un recordset con parametri. Questa operazione produce due risultati importanti, descritti di seguito.

Maggiore velocità di esecuzione.
Generazione di una query in fase di esecuzione basata su informazioni non disponibili in fase di progettazione, quali le informazioni specificate dall'utente finale o calcolate in fase di esecuzione.

Quando si chiama Open per eseguire la query, il recordset utilizza le informazioni dei parametri per completare la propria istruzione SQL SELECT. È possibile applicare parametri a qualsiasi recordset.

Utilizzo dei parametri

I parametri vengono in genere utilizzati per effettuare le operazioni descritte di seguito.

Passaggio di argomenti a una query già definita in fase di esecuzione.

Per passare i parametri a una stored procedure, quando si chiama Open è necessario specificare un'istruzione ODBC personalizzata CALL completa, con i segnaposto dei parametri, eseguendo l'override dell'istruzione SQL predefinita del recordset. Per ulteriori informazioni, vedere CRecordset::Open in Riferimenti alla libreria di classi e SQL: personalizzazione dell'istruzione SQL del recordset (ODBC) e Recordset: dichiarazione di una classe per una query già definita (ODBC).

Esecuzione di numerose ripetizioni di query utilizzando informazioni diverse sui parametri.

Per affrontare la situazione in cui l'utente finale cerca informazioni relative a un determinato studente nel database di registrazione degli studenti, ad esempio, è possibile impostare il nome o l'ID dello studente come parametro specificato dall'utente. Quando, in un secondo momento, si chiama la funzione membro Requery del recordset, la query seleziona solo il record dello studente.

Di seguito è riportato un esempio di stringa di filtro del recordset, memorizzata in m_strFilter.

"StudentID = ?"

Si supponga di recuperare l'ID dello studente nella variabile strInputID. Quando si imposta un parametro su strInputID, ad esempio l'ID studente 100, il valore della variabile viene associato al segnaposto del parametro rappresentato dal carattere ? nella stringa del filtro.

Assegnare il valore del parametro come indicato di seguito.

strInputID = "100";
...
m_strParam = strInputID;

Si consiglia di non impostare una stringa di filtro nel modo seguente:

m_strFilter = "StudentID = 100";   // 100 is incorrectly quoted
                                   // for some drivers

Per una descrizione sul corretto utilizzo delle virgolette nelle stringhe dei filtri, vedere Recordset: applicazione di filtri ai record (ODBC).

Ogni volta che si ripete una query nel recordset per trovare l'ID di un nuovo studente, il valore del parametro risulta diverso.

Suggerimento:
L'utilizzo di un parametro è più efficace rispetto all'utilizzo di un filtro. Nel caso di un recordset con parametri, infatti, è necessario che il database elabori l'istruzione SQL SELECT una sola volta. Nel caso di un recordset filtrato senza parametri, l'istruzione SELECT deve invece essere elaborata ogni volta che si esegue Requery con un nuovo valore di filtro.

Per ulteriori informazioni sui filtri, vedere Recordset: applicazione di filtri ai record (ODBC).

Applicazione di parametri alla classe del recordset

Nota:
Questa sezione si riferisce agli oggetti derivati da CRecordset per cui il recupero di massa di righe non è ancora stato implementato. L'implementazione dei parametri è un processo simile al recupero di massa di righe. Per ulteriori informazioni, vedere Set di record: recupero di massa di record (ODBC).

Prima di creare la classe del recordset, è necessario determinare i parametri necessari, i relativi tipi di dati e come verranno utilizzati dal recordset.

Per applicare parametri a una classe del recordset

Per creare la classe, eseguire la Creazione guidata consumer ODBC MFC scegliendo il comando Aggiungi classe.
Specificare i membri dati di campo per le colonne del recordset.
Dopo la scrittura della classe in un file del progetto tramite la procedura guidata, passare al file con estensione h e aggiungere manualmente uno o più membri dati di parametro alla dichiarazione della classe. L'operazione di aggiunta potrebbe essere simile all'esempio seguente, parte di una classe snapshot progettata per eseguire la query che recupera gli studenti che frequentano l'ultimo anno:
```
class CStudentSet : public CRecordset
{
// Field/Param Data
    CString m_strFirstName;
    CString m_strLastName;
    CString m_strStudentID;
    CString m_strGradYear;

    CString m_strGradYrParam;
};
```
Aggiungere i membri dati di parametro dopo i membri dati di campo generati dalla procedura guidata. Per convenzione si aggiunge la parola "Param" a ogni nome di parametro definito dall'utente.
Modificare la definizione della funzione membro DoFieldExchange nel file con estensione cpp. Aggiungere una chiamata alle funzioni RFX per ciascun membro dati di parametro aggiunto alla classe. Per informazioni sulla scrittura delle funzioni RFX, vedere Trasferimento di campi di record: funzionamento di RFX. Prima di chiamare RFX per i parametri, eseguire una singola chiamata a:
```
pFX->SetFieldType( CFieldExchange::param );
// RFX calls for parameter data members
```
Nel costruttore della classe del recordset incrementare il numero di parametri, m_nParams.

Per informazioni, vedere Trasferimento di campi di record: utilizzo del codice della creazione guidata.
Quando si scrive il codice per creare un oggetto recordset di questa classe, inserire il carattere "?" (punto interrogativo) in ogni punto delle stringhe dell'istruzione SQL in cui deve essere inserito un parametro.

In fase di esecuzione i segnaposto "?" vengono sostituiti, in ordine, con i valori dei parametri passati. Il primo membro dati di parametro impostato dopo la chiamata a SetFieldType sostituisce la prima occorrenza di "?" nella stringa SQL, il secondo membro dati di parametro sostituisce la seconda occorrenza di "?" e così via.

Nota:
L'ordine dei parametri è importante, in quanto è necessario che l'ordine delle chiamate a RFX per i parametri nella funzione DoFieldExchange corrisponda a quello dei segnaposto dei parametri nella stringa SQL.

Suggerimento:
In genere viene utilizzata la stringa specificata, se disponibile, per il membro dati m_strFilter della classe. Tuttavia, alcuni driver ODBC consentono l'utilizzo di parametri in altre clausole SQL.

Passaggio dei valori dei parametri in fase di esecuzione

È necessario specificare i valori dei parametri prima di chiamare Open per un nuovo oggetto recordset o Requery per un oggetto esistente.

Per passare i valori dei parametri a un oggetto recordset in fase di esecuzione

Creare l'oggetto recordset.
Preparare una o più stringhe, ad esempio m_strFilter, contenenti l'istruzione SQL o parti di essa. Immettere i segnaposto "?" nella posizione in cui verranno inserite le informazioni dei parametri.
Assegnare un valore di parametro in fase di esecuzione a ciascun membro dati di parametro dell'oggetto.
Chiamare la funzione membro Open o, per un recordset esistente, Requery.

Si supponga, ad esempio, di voler specificare una stringa di filtro per il recordset utilizzando le informazioni inserite in fase di esecuzione. Si presuma di aver creato in precedenza un recordset della classe CStudentSet, definito rsStudent, e che ora si desideri ripetere la query del recordset per ottenere un particolare tipo di informazioni relative agli studenti.

// Set up a filter string with 
// parameter placeholders
rsStudents.m_strFilter = "GradYear <= ?";

// Obtain or calculate parameter values 
// to pass--simply assigned here 
CString strGradYear = GetCurrentAcademicYear( );

// Assign the values to parameter data members
rsStudents.m_strGradYrParam = strGradYear;

// Run the query
if( !rsStudents.Requery( ) )
    return FALSE;

Il recordset contiene i record degli studenti che soddisfano le condizioni specificate dal filtro, creato dai parametri in fase di esecuzione. In questo caso, il recordset contiene i record di tutti gli studenti dell'ultimo anno.

Nota:
Se necessario, è possibile impostare il valore di un membro dati di parametro su Null, utilizzando SetParamNull. È inoltre possibile verificare se un membro dati di parametro sia impostato su Null utilizzando IsFieldNull.

Vedere anche

Concetti

Recordset (ODBC)

Recordset: aggiunta, aggiornamento ed eliminazione di record (ODBC)

Recordset: selezione dei record (ODBC)

Condividi tramite