Méthodes de consommateur générées par l'Assistant
Mise à jour : novembre 2007
L'Assistant Consommateur OLE DB ATL et l'Assistant Application MFC génèrent certaines fonctions que vous devez connaître. Notez que certaines méthodes sont implémentées différemment dans les projets avec attributs, d'où la présence de quelques avertissements ; chaque cas est abordé ci-après. Pour plus d'informations sur l'affichage de code injecté, consultez Débogage de code injecté.
OpenAll ouvre la source de données, les jeux de lignes et active les signets le cas échéant.
CloseAll ferme tous les jeux de lignes ouverts et diffuse l'exécution de toutes les commandes.
OpenRowset est appelée par OpenAll pour ouvrir les jeux de lignes du consommateur.
GetRowsetProperties récupère un pointeur désignant le jeu de propriétés du jeu de lignes permettant de définir les propriétés.
OpenDataSource ouvre la source de données à l'aide de la chaîne d'initialisation spécifiée dans la boîte de dialogue Propriétés des liaisons de données.
CloseDataSource ferme la source de données d'une manière appropriée.
OpenAll et CloseAll
HRESULT OpenAll();
void CloseAll();
L'exemple suivant montre comment appeler OpenAll et CloseAll lorsque vous exécutez la même commande de façon répétée. Comparez l'exemple de code suivant dans CCommand::Close, qui montre une variation qui appelle Close et ReleaseCommand à la place de CloseAll.
int main(int argc, char* argv[])
{
HRESULT hr;
hr = CoInitialize(NULL);
CCustOrdersDetail rs; // Your CCommand-derived class
rs.m_OrderID = 10248; // Open order 10248
hr = rs.OpenAll(); // (Open also executes the command)
hr = rs.MoveFirst(); // Move to the first row and print it
printf( "Name: %s, Unit Price: %d, Quantity: %d, Discount %d, Extended Price %d\n", rs.m_ProductName, rs.m_UnitPrice.int64, rs.m_Quantity, rs.m_Discount, rs.m_ExtendedPrice.int64 );
// Close the first command execution
rs.Close();
rs.m_OrderID = 10249; // Open order 10249 (a new order)
hr = rs.Open(); // (Open also executes the command)
hr = rs.MoveFirst(); // Move to the first row and print it
printf( "Name: %s, Unit Price: %d, Quantity: %d, Discount %d, Extended Price %d\n", rs.m_ProductName, rs.m_UnitPrice.int64, rs.m_Quantity, rs.m_Discount, rs.m_ExtendedPrice.int64 );
// Close the second command execution;
// Instead of rs.CloseAll() you could call
// rs.Close() and rs.ReleaseCommand():
rs.CloseAll();
CoUninitialize();
return 0;
}
Notes
Remarquez que si vous définissez une méthode HasBookmark, le code OpenAll définit la propriété DBPROP_IRowsetLocate ; veillez à n'effectuer une telle opération que si votre fournisseur prend en charge cette propriété.
OpenRowset
// OLE DB Template version:
HRESULT OpenRowset(DBPROPSET* pPropSet = NULL)
// Attribute-injected version:
HRESULT OpenRowset(const CSession& session, LPCWSTR szCommand = NULL);
OpenAll appelle cette méthode pour ouvrir les jeux de lignes dans le consommateur. En général, vous ne devez pas appeler OpenRowset, sauf si vous souhaitez travailler avec plusieurs sources de données/sessions/jeux de lignes. OpenRowset est déclarée dans le fichier d'en-tête de la classe de commande ou de table :
// OLE DB Template version:
HRESULT OpenRowset(DBPROPSET *pPropSet = NULL)
{
HRESULT hr = Open(m_session, NULL, pPropSet);
#ifdef _DEBUG
if(FAILED(hr))
AtlTraceErrorRecords(hr);
#endif
return hr;
}
Les attributs implémentent cette méthode différemment. Cette version accepte un objet session et une chaîne de commande qui correspond par défaut à la chaîne de commande spécifiée dans db_command, même si vous pouvez en passer une autre. Remarquez que si vous définissez une méthode HasBookmark, le code OpenRowset définit la propriété DBPROP_IRowsetLocate ; veillez à n'effectuer une telle opération que si votre fournisseur prend en charge cette propriété.
// Attribute-injected version:
HRESULT OpenRowset(const CSession& session, LPCWSTR szCommand=NULL)
{
DBPROPSET *pPropSet = NULL;
CDBPropSet propset(DBPROPSET_ROWSET);
__if_exists(HasBookmark)
{
propset.AddProperty(DBPROP_IRowsetLocate, true);
pPropSet= &propset;
}
...
}
GetRowsetProperties
void GetRowsetProperties(CDBPropSet* pPropSet);
Cette méthode récupère un pointeur vers le jeu de propriétés du jeu de lignes ; vous pouvez utiliser ce pointeur pour définir des propriétés telles que DBPROP_IRowsetChange. GetRowsetProperties est utilisé dans la classe d'enregistrement utilisateur de la manière suivante. Vous pouvez modifier ce code afin de définir des propriétés supplémentaires pour le jeu de lignes :
void GetRowsetProperties(CDBPropSet* pPropSet)
{
pPropSet->AddProperty(DBPROP_CANFETCHBACKWARDS, true, DBPROPOPTIONS_OPTIONAL);
pPropSet->AddProperty(DBPROP_CANSCROLLBACKWARDS, true, DBPROPOPTIONS_OPTIONAL);
pPropSet->AddProperty(DBPROP_IRowsetChange, true, DBPROPOPTIONS_OPTIONAL);
pPropSet->AddProperty(DBPROP_UPDATABILITY, DBPROPVAL_UP_CHANGE | DBPROPVAL_UP_INSERT | DBPROPVAL_UP_DELETE);
}
Notes
Vous ne devez pas définir une méthode GetRowsetProperties globale, car elle risque d'entrer en conflit avec celle définie par l'Assistant. Vous pouvez noter qu'il s'agit d'une méthode générée par l'Assistant que vous obtenez avec des projets pourvus de modèles et d'attributs ; les attributs n'injectent pas ce code.
OpenDataSource et CloseDataSource
HRESULT OpenDataSource();
void CloseDataSource();
Notes
L'Assistant définit les méthodes OpenDataSource et CloseDataSource ; OpenDataSource appelle CDataSource::OpenFromInitializationString.