mettre à jour les jeux de lignes

Une opération de base de données très simple consiste à mettre à jour ou à écrire des données dans la base de données. Dans OLE DB, le mécanisme de mise à jour est simple : votre application consommatrice définit les valeurs des membres de données liés, puis écrit ces valeurs dans le rowset ; le consommateur demande ensuite au fournisseur de mettre à jour le magasin de données.

Les consommateurs peuvent effectuer les types de mises à jour suivants sur les données d’ensemble de lignes : définition des valeurs des colonnes dans une ligne, insertion d’une ligne et suppression d’une ligne. Pour effectuer ces opérations, la classe de modèle OLE DB CRowset implémente l’interface IRowsetChange et remplace les méthodes suivantes de l’interface :

• SetData change les valeurs des colonnes dans une ligne d’un ensemble de lignes. Elle est équivalente à la commande SQL UPDATE.

• Insert insère une ligne dans un ensemble de lignes. Elle est équivalente à la commande SQL INSERT.

• Delete supprime une ligne d’un ensemble de lignes. Elle est équivalente à la commande SQL DELETE.

Prise en charge des opérations de mise à jour

Remarque

L’Assistant Consommateur OLE DB ATL n’est pas disponible dans Visual Studio 2019 et versions ultérieures. Vous pouvez toujours ajouter la fonctionnalité manuellement. Pour plus d’informations, consultez Création d’un consommateur sans utiliser l’Assistant.

Quand vous créez un consommateur avec l’Assistant Consommateur OLE DB ATL, vous pouvez prendre en charge les opérations de mise à jour en cochant une ou plusieurs des trois cases à cocher Modifier, Inséreret Supprimer. Si vous sélectionnez ces options, l’Assistant modifie le code en conséquence de façon à prendre en charge le type des modifications que vous choisissez. Cependant, si vous n’utilisez pas l’Assistant, vous devez définir les propriétés d’ensemble de lignes suivantes sur VARIANT_TRUE pour prendre en charge les mises à jour :

• DBPROPVAL_UP_CHANGE vous permet de modifier les valeurs des données dans une ligne.

• DBPROPVAL_UP_INSERT vous permet d’insérer une ligne.

• DBPROPVAL_UP_DELETE vous permet de supprimer une ligne.

Vous définissez les propriétés comme suit :

CDBPropSet ps(DBPROPSET_ROWSET);

ps.AddProperty(DBPROP_IRowsetChange, true);
ps.AddProperty(DBPROP_UPDATABILITY, DBPROPVAL_UP_CHANGE | DBPROPVAL_UP_INSERT | DBPROPVAL_UP_DELETE);

Les opérations de modification, d’insertion ou de suppression peuvent échouer si une ou plusieurs colonnes ne sont pas accessibles en écriture. Modifiez le mappage de votre curseur pour corriger ce problème.

Définition de données dans des lignes

CRowset::SetData définit les valeurs des données dans une ou plusieurs colonnes de la ligne actuelle. Le code suivant définit les valeurs des membres de données liés aux colonnes Name et Units in Stock du tableau Products, puis appelle SetData pour écrire ces valeurs dans la 100e ligne de l’ensemble de lignes :

// Instantiate a rowset based on the user record class
CTable<CAccessor<CProductAccessor>> product;
CSession session;

// Open the rowset and move to the 100th row
product.Open(session, "Product", &ps, 1);  // ps is the property set
product.MoveToBookmark(&bookmark, 0);      // Assume that bookmark is set to 100th row

// Change the values of columns "Name" and "Units in Stock" in the current row of the Product table
_tcscpy_s(product.m_ProductName, product.m_sizeOfProductName, _T( "Candle" ) );

product.m_UnitsInStock = 10000;

// Set the data
HRESULT hr = product.SetData();

Insertion de lignes dans des rowsets

CRowset::Insert crée et initialise une ligne en utilisant les données provenant de l’accesseur. Insert crée une toute nouvelle ligne après la ligne active. Vous devez spécifier si vous voulez faire passer la ligne active à la ligne suivante ou la laisser inchangée. Pour cela, vous définissez le paramètre bGetRow :

HRESULT Insert(int nAccessor = 0, bool bGetRow = false)

• false (la valeur par défaut) spécifie que l’incrément de ligne actuelle à la ligne suivante (auquel cas elle pointe vers la ligne insérée).

• true spécifie que la ligne actuelle reste là où elle se trouve.

Le code suivant définit les valeurs des membres de données liés aux colonnes du tableau Products, puis appelle Insert pour insérer une nouvelle ligne avec ces valeurs après la 100e ligne de l’ensemble de lignes. Il est recommandé de définir toutes les valeurs des colonnes afin d’éviter des données non définies dans la nouvelle ligne :

// Instantiate a rowset based on the user record class
CTable<CAccessor<CProductAccessor>> product;
CSession session;

// Open the rowset and move to the 100th row
product.Open(session, "Product", &ps, 1);  // ps is the property set
product.MoveToBookmark(&bookmark, 0);      // Assume that bookmark is set to 100th row

// Set the column values for a row of the Product table, then insert the row
product.m_ProductID = 101;
_tcscpy_s(product.m_ProductName, product.m_sizeOfProductName, _T( "Candle" ) );

product.m_SupplierID = 27857;
product.m_CategoryID = 372;
_tcscpy_s(product.m_QuantityPerUnit, product.m_sizeOfQuantityPerUnit, _T( "Pack of 10" ) );

product.m_UnitPrice = 20;
product.m_UnitsInStock = 10000;
product.m_UnitsOnOrder = 5201;
product.m_ReorderLevel = 5000;
product.m_Discontinued = false;

// You must also initialize the status and length fields before setting/inserting data
// Set the column status values
m_dwProductIDStatus = DBSTATUS_S_OK;
m_dwProductNameStatus = DBSTATUS_S_OK;
m_dwSupplierIDStatus = DBSTATUS_S_OK;
m_dwCategoryIDStatus = DBSTATUS_S_OK;
m_dwQuantityPerUnitStatus = DBSTATUS_S_OK;
m_dwUnitPriceStatus = DBSTATUS_S_OK;
m_dwUnitsInStockStatus = DBSTATUS_S_OK;
m_dwUnitsOnOrderStatus = DBSTATUS_S_OK;
m_dwReorderLevelStatus = DBSTATUS_S_OK;
m_dwDiscontinuedStatus = DBSTATUS_S_OK;

// Set the column length value for column data members that are not fixed-length types.
// The value should be the length of the string that you are setting.
m_dwProductNameLength = 6;             // "Candle" has 6 characters
m_dwQuantityPerUnitLength = 10;        // "Pack of 10" has 10 characters

// Insert the data
HRESULT hr = product.Insert();

Pour obtenir un exemple plus détaillé, consultez CRowset::Insert.

Pour plus d’informations sur la définition des données membres d’état et de longueur, consultez Membres de données d’état des champs dans les accesseurs générés par un Assistant.

Suppression de lignes dans les rowsets

CRowset::Delete supprime la ligne active du rowset. Le code suivant appelle Delete pour supprimer la 100e ligne de l’ensemble de lignes :

// Instantiate a rowset based on the user record class
CTable<CAccessor<CProductAccessor>> product;
CSession session;

// Open the rowset and move to the 100th row
product.Open(session, "Product", &ps, 1);  // ps is the property set
product.MoveToBookmark(&bookmark, 0);      // Assume that bookmark is set to 100th row

// Delete the row
HRESULT hr = product.Delete();

Mises à jour immédiates et différées

Sauf indication contraire, les appels aux méthodes SetData, Insert, et Delete mettent à jour le magasin de données immédiatement. Vous pouvez cependant différer les mises à jour, afin que le consommateur stocke toutes les modifications dans un cache local, puis les transfère vers le magasin de données quand vous appelez une des méthodes de mise à jour suivantes :

• CRowset::Update transfère toute modification en attente apportée à la ligne active depuis la dernière extraction ou depuis le dernier appel Update sur cette ligne.

• CRowset::UpdateAll transfère toute modification en attente apportée à toutes les lignes depuis la dernière extraction ou depuis le dernier appel Update sur cette ligne.

Notez qu’une mise à jour, telle qu’elle est utilisée par les méthodes de mise à jour, consiste à apporter des modifications sur commande ; elle ne doit pas être confondue avec la commande SQL UPDATE (SetData est équivalent à la commande SQL UPDATE).

Les mises à jour différées sont utiles, par exemple, dans le cas d’une série de transactions bancaires. Si une transaction est annulée, vous pouvez annuler la modification, car vous n’envoyez pas la série de modifications tant que la dernière n’est pas validée. En outre, le fournisseur peut regrouper les modifications en un seul appel réseau, qui est plus efficace.

Pour prendre en charge les mises à jour différées, vous devez définir la propriété DBPROP_IRowsetChange en plus des propriétés décrites dans Prise en charge des opérations de mise à jour :

pPropSet->AddProperty(DBPROP_IRowsetUpdate, true);

Quand vous appelez Update ou UpdateAll, les méthodes transfèrent les modifications du cache local vers la banque de données, puis effacent le cache local. Étant donné que la mise à jour transfère les modifications seulement pour la ligne active, il est important que votre application fasse le suivi de la ligne à mettre à jour et du moment où elle doit être mise à jour. L’exemple suivant montre comment mettre à jour deux lignes consécutives :

// Instantiate a rowset based on the user record class
CTable<CAccessor<CProductAccessor>> product;
CSession session;

// Open the rowset and move to the 100th row
product.Open(session, "Product", &ps, 1);  // ps is the property set
product.MoveToBookmark(&bookmark, 0);      // Assume that bookmark is set to 100th row

// Change the values of columns "Name" and "Units in Stock" in the 100th row of the Product table
_tcscpy_s(product.m_ProductName, product.m_sizeOfProductName, _T( "Wick" ) );

product.m_UnitsInStock = 10000;

HRESULT hr = product.SetData();  // No changes made to row 100 yet
product.Update();                 // Update row 100 now

// Change the values of columns "Name" and "Units in Stock" in the 101st row of the Product table
product.MoveNext();

_tcscpy_s(product.m_ProductName, product.m_sizeOfProductName _T( "Wax" ) );

product.m_UnitsInStock = 500;

HRESULT hr = product.SetData();  // No changes made to row 101 yet
product.Update();                 // Update row 101 now

Pour faire en sorte que les modifications en attente soient effectivement transférées, vous devez appeler Update avant de passer à une autre ligne. Cependant, si c’est fastidieux ou inefficace, par exemple quand votre application doit mettre à jour des centaines de lignes, vous pouvez utiliser UpdateAll pour mettre à jour toutes les lignes à la fois.

Par exemple, si le premier appel à Update ne se trouvait pas dans le code ci-dessus, la ligne 100 resterait inchangée, alors que la ligne 101 serait modifiée. Après cela, votre application devrait appeler UpdateAll ou revenir à la ligne 100 et appeler Update pour que cette ligne soit mise à jour.

Enfin, une des principales raisons de différer des modifications est la possibilité de les annuler. L’appel à CRowset::Undo rétablit l’état du cache local des modifications à l’état du magasin de données avant que les modifications aient été apportées. Il est important de noter que Undo ne restaure pas l’état du cache local à l’étape immédiatement précédente (c’est-à-dire seulement à l’état précédant la dernière modification), mais efface en fait le cache local pour cette ligne. En outre, Undo affecte seulement la ligne active.

Voir aussi

Utilisation des modèles du consommateur OLE DB
CRowset, classe
IRowsetChange