db_command

Crea un comando OLE DB.

[ db_command( 
   command, 
   name, 
   source_name, 
   hresult, 
   bindings, 
   bulk_fetch)
]

Parametri

  • command
    Una stringa di comando che contiene il testo di un comando OLE DB.Un semplice esempio è:

     [ db_command ( command = "Select * from Products" ) ]
    

    comando la sintassi è la seguente:

    binding parameter block 1
       OLE DB command
    binding parameter block 2
       continuation of OLE DB command
    binding parameter block 3
    ...
    

    In blocco obbligatorio di parametro viene definito come segue:

    ([bindtype**]** szVar1 [, szVar2 [, nVar3 [,]…]] )

    Dove:

    ( contrassegna l'inizio del blocco di associazione dati.

    [bindtype] è una delle stringhe senza distinzione tra maiuscole e minuscole:

    • [db_column] associa ciascuna delle variabili membro a una colonna in un rowset.

    • [bindto] (equivale a [db_column]).

    • [in] associa le variabili membro come parametri di input.

    • [out] associa le variabili membro come parametri di output.

    • [in, out] associa le variabili membro come parametri di input/output.

    SzVarX punta a una variabile membro nell'ambito corrente.

    ) contrassegna la fine del blocco di associazione dati.

    se la stringa di comando contiene uno o più identificatori come [in] [out], o [in/out], db_command compila una mappa dei parametri.

    se la stringa di comando contiene uno o più parametri come [db_column] o [bindto], db_command genera un rowset e un mapping della funzione di accesso per soddisfare queste variabili associate.vedere db_accessor per ulteriori informazioni.

    [!NOTA]

    [bindtype] sintassi e bindings il parametro non è valido in caso di utilizzo db_command a livello di classe.

    Di seguito sono riportati alcuni esempi di blocchi di associazione di parametro.Nell'esempio seguente viene associato m_au_fname e m_au_lname membri dati a au_fname e au_lname colonne, rispettivamente, della tabella authors del database pubs:

    TCHAR m_au_fname[21];
    TCHAR m_au_lname[41];
    TCHAR m_state[3] = 'CA';
    
    [db_command (
       command = "SELECT au_fname([bindto]m_au_fname), au_lname([bindto]m_au_lname) " \
       "FROM dbo.authors " \
       "WHERE state = ?([in]m_state)")
    

    ]

  • nome (facoltativo)
    Il nome dell'handle utilizzati per utilizzare il rowset.Se si specifica nome, db_command genera una classe con specificato nome, che può essere utilizzato per scorrere il rowset o per eseguire query di azione più.Se non si specifica nome, non sarà possibile restituire più righe di risultati all'utente.

  • source_name (facoltativo)
    CSession variabile o istanza di una classe che ha db_source attributo applicato a sul quale il comando viene eseguito.vedere db_source.

    db_command controlli da garantire che la variabile utilizzata per source_name è valido, pertanto la variabile specificata deve trovarsi nella funzione o nell'ambito globale.

  • hresult (facoltativo)
    identifica la variabile che riceverà HRESULT di questo comando di database.Se la variabile non esiste, verrà automaticamente inserita dall'attributo.

  • associazioni (facoltativo)
    Consente di separare i parametri richiesti dal comando OLE DB.

    Se si specifica un valore per bindings, db_command analizza il valore associato e non analizza [bindtype] parametro.Questo utilizzo consente di sintassi provider OLE DB di utilizzo.per disabilitare l'analisi, senza parametri obbligatori, specificare "" Di Bindings=.

    Se non si specifica un valore per bindings, db_command analizza il blocco obbligatorio di parametro, trovando '(“, seguito da [bindtype] tra parentesi, seguiti da uno o più precedentemente dichiarata le variabili membro di C++, seguiti da serializzarne**)**“.Tutto il testo tra le parentesi verrà rimosso dal comando risultante e questi parametri saranno utilizzati per costruire la colonna e le associazioni di parametri per questa sequenza.

  • bulk_fetch(facoltativo)
    Un valore intero che specifica il numero di righe da recuperare.

    Il valore predefinito è 1, che specifica solo il recupero della riga (rowset di sarà di tipo CRowset).

    Un valore maggiore di 1 specifica il recupero di massa di righe.Il recupero di massa di righe " si riferisce alla possibilità dei rowset di massa di recuperare l'handle di riga più (rowset di sarà di tipo CBulkRowset e chiamerà SetRows con il numero specificato di righe).

    se bulk_fetch è minore di uno, SetRows restituirà zero.

Note

db_command crea un oggetto Di CCommand oggetto, utilizzato da un consumer OLE DB per eseguire un comando.

È possibile utilizzare db_command con classe o dell'ambito della funzione, la differenza principale è l'ambito di l CCommand oggetto.Nell'ambito della funzione, i dati come associazioni terminano alla fine della funzione.Sia gli utilizzi dell'ambito della funzione della classe includono la classe di modelli consumer OLE DB CCommand<>, ma gli argomenti di template differiscono per i casi della classe e di funzione.Nel caso di funzione, le associazioni verranno apportate a funzione di accesso che include le variabili locali, mentre l'utilizzo della classe a desumere un oggetto CAccessorclasse derivata da come argomento.Una volta utilizzato come attributo della classe, db_command opera congiuntamente a db_column.

db_command può essere utilizzato per eseguire i comandi che restituiscono un gruppo di risultati.

Quando il provider di tipo consumer di attributo applicato questo attributo a una classe, il compilatore la classe a _TheClassNamefunzione di accesso, dove TheClassName è il nome assegnato alla classe e il compilatore inoltre creata una classe denominata TheClassName, quale deriva da _TheClassNamefunzione di accesso.In Visualizzazione classi, verranno visualizzate entrambe le classi.

Esempio

In questo esempio viene definito un comando che consente di selezionare il primo e il cognome da una tabella in cui la CA di stato delle corrispondenze della colonna„.db_command crea e legge un rowset in cui è possibile chiamare le funzioni generate mediante la creazione guidata come OpenAll e CloseAllnonché CRowset funzioni membro come MoveNext.

Si noti che questo codice è necessario specificare per contenere la stringa di connessione che connette a pub il database.Per informazioni su come eseguire questa operazione nell'ambiente di sviluppo, vedere Procedura: connettersi a un database da Esplora server e Procedura: Aggiungere nuove connessioni dati in Esplora server/Esplora database.

// db_command.h
#include <atlbase.h>
#include <atlplus.h>
#include <atldbcli.h>

#pragma once

[  db_source(L"your connection string"),
   db_command(L" \
      SELECT au_lname, au_fname \
      FROM dbo.authors \
      WHERE state = 'CA'")  ]

struct CAuthors {
   // In order to fix several issues with some providers, the code below may bind
   // columns in a different order than reported by the provider

   DBSTATUS m_dwau_lnameStatus;
   DBSTATUS m_dwau_fnameStatus;
   DBLENGTH m_dwau_lnameLength;
   DBLENGTH m_dwau_fnameLength;

   [ db_column("au_lname", status="m_dwau_lnameStatus", length="m_dwau_lnameLength") ] TCHAR m_au_lname[41];
   [ db_column("au_fname", status="m_dwau_fnameStatus", length="m_dwau_fnameLength") ] TCHAR m_au_fname[21];

   [ db_param("7", paramtype="DBPARAMIO_INPUT") ] TCHAR m_state[3];
   

   void GetRowsetProperties(CDBPropSet* pPropSet) {
      pPropSet->AddProperty(DBPROP_CANFETCHBACKWARDS, true, DBPROPOPTIONS_OPTIONAL);
      pPropSet->AddProperty(DBPROP_CANSCROLLBACKWARDS, true, DBPROPOPTIONS_OPTIONAL);
   }
};

// db_command.cpp
// compile with: /c
#include "db_command.h"

int main(int argc, _TCHAR* argv[]) {
   HRESULT hr = CoInitialize(NULL);

   // Instantiate rowset
   CAuthors rs;

   // Open rowset and move to first row
   strcpy_s(rs.m_state, sizeof(rs.m_state), _T("CA"));
   hr = rs.OpenAll();
   hr = rs.MoveFirst();
   
   // Iterate through the rowset
   while( SUCCEEDED(hr) && hr != DB_S_ENDOFROWSET ) {
      // Print out the column information for each row
      printf("First Name: %s, Last Name: %s\n", rs.m_au_fname, rs.m_au_lname);
      hr = rs.MoveNext();
   }

   rs.CloseAll();
   CoUninitialize();
}

In questo esempio viene utilizzato db_source in una classe di origine dati CMySourcee db_command le classi dei comandi CCommand1 e CCommand2.

// db_command_2.cpp
// compile with: /c
#include <atlbase.h>
#include <atlplus.h>
#include <atldbcli.h>
// class usage for both db_source and db_command

[  db_source(L"your connection string"),
   db_command(L" \
      SELECT au_lname, au_fname \
      FROM dbo.authors \
      WHERE state = 'CA'")  ]
struct CMySource {
   HRESULT OpenDataSource() {
      return S_OK;
   }
};

[db_command(command = "SELECT * FROM Products")]
class CCommand1 {};

[db_command(command = "SELECT FNAME, LNAME FROM Customers")]
class CCommand2 {};

int main() {
   CMySource s;
   HRESULT hr = s.OpenDataSource();
   if (SUCCEEDED(hr)) {
      CCommand1 c1;
      hr = c1.Open(s);

      CCommand2 c2;
      hr = c2.Open(s);
   }

   s.CloseDataSource();
}

Requisiti

contesto di attributo

Si applica a

classe, struct, membro, metodo, locale

ripetibile

No

attributi obbligatori

Nessuno

attributi non validi

Nessuno

per ulteriori informazioni sui contesti di attributo, vedere Associare ai contesti.

Vedere anche

Altre risorse

Attributi del consumer OLE DB

Attributi autonomi

Attributes Samples