Implementowanie prostego konsumenta

Kreator konsumenta OLE DB ATL nie jest dostępny w programie Visual Studio 2019 i nowszych wersjach. Nadal można dodać funkcjonalność ręcznie. Aby uzyskać więcej informacji, zobacz Tworzenie konsumenta bez korzystania z Kreatora.

W poniższych tematach pokazano, jak edytować pliki utworzone przez Kreatora aplikacji MFC i Kreatora konsumenta OLE DB ATL w celu utworzenia prostego użytkownika. Ten przykład zawiera następujące części:

• Pobieranie danych za pomocą odbiorcy pokazuje, jak zaimplementować kod w odbiorcy, który odczytuje wszystkie dane, wiersz po wierszu, z tabeli bazy danych.

• Dodanie obsługi zakładek do odbiorcy pokazuje, jak dodać obsługę zakładek do odbiorcy.

Pobieranie danych z użytkownikiem

Aby zmodyfikować aplikację konsolową tak, aby korzystała z konsumenta OLE DB

1. W MyCons.cpppliku zmień kod główny, wstawiając pogrubiony tekst w następujący sposób:

   // MyCons.cpp : Defines the entry point for the console application.
   //
   #include "pch.h" // "stdafx.h" in Visual Studio 2017 and earlier
   #include "Products.h"
   ...
   int main(int argc, char* argv[])
   {
      HRESULT hr = CoInitialize(NULL);   // Instantiate rowset
      CProducts rs;
      hr = rs.OpenAll();
      ATLASSERT(SUCCEEDED(hr ) );
      hr = rs.MoveFirst();   // Iterate through the rowset
      while(SUCCEEDED(hr) && hr != DB_S_ENDOFROWSET )   {      // Print out the column information for each row
        printf("Product ID: %d, Name: %s, Unit Price: %d, Quantity per Unit: %d, Units in Stock %d, Reorder Level %d\n",
          rs.m_ProductID, rs.m_ProductName, rs.m_UnitPrice, rs.m_QuantityPerUnit, rs.m_UnitsInStock, rs.m_ReorderLevel );
        hr = rs.MoveNext();   }
      rs.Close();
      rs.ReleaseCommand();
      CoUninitialize();
   
      return 0;
   }
   

Dodawanie obsługi zakładek do odbiorcy

Zakładka to kolumna, która unikatowo identyfikuje wiersze w tabeli. Zazwyczaj jest to kolumna klucza, ale nie zawsze; jest specyficzny dla dostawcy. W tej sekcji przedstawiono sposób dodawania obsługi zakładek. W tym celu należy wykonać następujące kroki w klasie rekordów użytkownika:

• Utwórz wystąpienie zakładek. Są to obiekty typu CBookmark.

• Zażądaj kolumny zakładki od dostawcy, ustawiając DBPROP_IRowsetLocate właściwość .

• Dodaj wpis zakładki do mapy kolumn przy użyciu makra BOOKMARK_ENTRY .

Poprzednie kroki zapewniają obsługę zakładek i obiekt zakładki, z którym można pracować. W tym przykładzie kodu przedstawiono zakładkę w następujący sposób:

• Otwórz plik do zapisu.

• Dane wyjściowe zestawu wierszy do wiersza pliku według wiersza.

• Przenieś kursor zestawu wierszy do zakładki, wywołując polecenie MoveToBookmark.

• Wyprowadź wiersz zakładki, dołączając go na końcu pliku.

Aby utworzyć wystąpienie zakładki

1. Akcesorium musi przechowywać obiekt typu CBookmark. Parametr nSize określa rozmiar buforu zakładki w bajtach (zazwyczaj 4 dla platform 32-bitowych i 8 dla platform 64-bitowych). Dodaj następującą deklarację do składowych danych kolumn w klasie rekordów użytkownika:

   //////////////////////////////////////////////////////////////////////
   // Products.h
   class CProductsAccessor
   {
   public:
      CBookmark<4> m_bookmark;   // Add bookmark declaration
      LONG m_ProductID;
      ...
   

Aby zażądać kolumny zakładki od dostawcy

1. Dodaj następujący kod w metodzie GetRowsetProperties w klasie rekordów użytkownika:

   // Set the DBPROP_IRowsetLocate property.
   void GetRowsetProperties(CDBPropSet* pPropSet)
   {
      pPropSet->AddProperty(DBPROP_CANFETCHBACKWARDS, true, DBPROPOPTIONS_OPTIONAL);
      pPropSet->AddProperty(DBPROP_CANSCROLLBACKWARDS, true, DBPROPOPTIONS_OPTIONAL);
      // Add DBPROP_IRowsetLocate property to support bookmarks   pPropSet->AddProperty(DBPROP_IRowsetLocate, true);
   }
   

Aby dodać wpis zakładki do mapy kolumn

1. Dodaj następujący wpis do mapy kolumn w klasie rekordów użytkownika:

   // Set a bookmark entry in the column map.
   BEGIN_COLUMN_MAP(CProductsAccessor)
      BOOKMARK_ENTRY(m_bookmark)   // Add bookmark entry
      COLUMN_ENTRY_LENGTH_STATUS(1, m_ProductID, m_dwProductIDLength, m_dwProductIDStatus)
      COLUMN_ENTRY_LENGTH_STATUS(2, m_ProductName, m_dwProductNameLength, m_dwProductNameStatus)
   ...
   END_COLUMN_MAP()
   

Aby użyć zakładki w kodzie głównym

1. MyCons.cpp W pliku z utworzonej wcześniej aplikacji konsolowej zmień kod główny, aby był odczytywany w następujący sposób. Aby używać zakładek, główny kod musi utworzyć wystąpienie własnego obiektu zakładki (myBookmark); jest to inna zakładka niż ta w metodzie dostępu (m_bookmark).

   ///////////////////////////////////////////////////////////////////////
   // MyCons.cpp : Defines the entry point for the console application.
   //
   
   #include "stdafx.h"
   #include "Products.h"
   #include <iostream>
   #include <fstream>
   using namespace std;
   
   int _tmain(int argc, _TCHAR* argv[])
   {
      HRESULT hr = CoInitialize(NULL);
   
      // Instantiate rowset
      CProducts rs;
   
      hr = rs.OpenAll();
      hr = rs.MoveFirst();
   
      // Cast CURRENCY m_UnitPrice to a long value
      LONGLONG lPrice = rs.m_UnitPrice.int64;
   
      // Open file output.txt for writing in overwrite mode
      ofstream outfile( "C:\\output.txt", ios::out );
   
      if (!outfile)      // Test for invalid file
         return -1;
   
      // Instantiate a bookmark object myBookmark for the main code
      CBookmark<4> myBookmark;
      int nCounter = 0;
   
      // Iterate through the rowset and output column data to output.txt row by row
      // In the file, mark the beginning of this set of data:
      outfile << "initial row dump" << endl;
      while(SUCCEEDED(hr) && hr != DB_S_ENDOFROWSET )
      {
         nCounter++;
         if(nCounter == 5 )
            myBookmark = rs.m_bookmark;
         // Output the column information for each row:
         outfile << rs.m_ProductID << rs.m_ProductName << lPrice << rs.m_QuantityPerUnit << rs.m_UnitsInStock << rs.m_ReorderLevel << endl;
         hr = rs.MoveNext();
      }
   
      // Move cursor to bookmark
      hr = rs.MoveToBookmark(myBookmark);
   
      // Iterate through the rowset and output column data to output.txt row by row
      // In the file, mark the beginning of this set of data:
      outfile << "row dump starting from bookmarked row" << endl;
      while(SUCCEEDED(hr) && hr != DB_S_ENDOFROWSET )
      {
         // Output the column information for each row
         outfile << rs.m_ProductID << rs.m_ProductName << lPrice << rs.m_QuantityPerUnit << rs.m_UnitsInStock << rs.m_ReorderLevel << endl;
         hr = rs.MoveNext();
      }
   
      rs.CloseAll();
      CoUninitialize();
   
      return 0;
   }
   

Aby uzyskać więcej informacji na temat zakładek, zobacz Używanie zakładek. Przykłady zakładek są również wyświetlane w temacie Aktualizowanie zestawów wierszy.