TN054: Вызов DAO непосредственно при использовании MFC DAO представлена классификация

Статья
03/12/2013

Примечание
Что касается Visual C++ .NET, то среда и мастера Visual C++ больше не поддерживают DAO (хотя классы DAO включены и вы по-прежнему можете их использовать).Майкрософт рекомендует использовать Шаблоны OLE DB или ODBC и MFC для новых проектов.DAO необходимо использовать только для поддержки существующих приложений.

Что касается Visual C++ .NET, то среда и мастера Visual C++ больше не поддерживают DAO (хотя классы DAO включены и вы по-прежнему можете их использовать).Майкрософт рекомендует использовать Шаблоны OLE DB или ODBC и MFC для новых проектов.DAO необходимо использовать только для поддержки существующих приложений.

При использовании классов баз данных MFC DAO, могут возникнуть ситуации, когда необходимо использовать DAO напрямую.Обычно это неприменимо, но MFC предоставляется некоторые механизмы поддержки для упрощения вызывать непосредственно DAO простым, сочетающий использование классов MFC DAO непосредственно с вызовами.Выполнение прямых вызовов методов DAO в образце управлениеого объекта должен DAO требуется только несколько строк кода.Если необходимо создать и использовать объекты, управляемых MFC DAO, не следует делать несколько больше работы является вызов метода Выпуск для объекта.Это объясняется техническое примечание при необходимости вызова DAO напрямую, что вспомогательные MFC могут сделать, чтобы помочь и как использовать интерфейсы OLE DAO.Наконец, эта заметка предоставляет некоторые функции пример, показывающий, как вызова DAO непосредственно для функций безопасности DAO.

Если он непосредственно DAO

Наиболее распространенные ситуации для создания непосредственно DAO возникают, когда коллекции необходимо обновить или при реализации функции не созданных программу-оболочку MFC.Функция не значительно представленной MFC безопасности.Если необходимо реализовать функции безопасности, необходимо использовать объекты пользователей и групп DAO напрямую.Помимо безопасности, существует несколько других функций, не поддерживаемых MFC DAO.Эти функции включают клонирования и репликации базы данных набора записей, так и нескольких последних добавлений в DAO.

Краткий обзор реализации DAO и MFC

Обертывание MFC DAO делает использование DAO проще, обработки множества данных, поэтому не нужно беспокоиться о маленьких действиях.Это включает инициализацию OLE, создания и управления объектов DAO (особенно объектов коллекции), проверки ошибок, а также являются строго типизированными, более простой интерфейс (без аргументов VARIANT или BSTR ).Можно напрямую осуществляет DAO и по-прежнему воспользоваться преимуществами этих функций.Весь код должен выполнить вызов метода Выпуск для всех объектов, созданных непосредственно вызовами DAO и не любое изменение указателей интерфейса, MFC может полагаться на внутренне.Например, не изменяйте элемент m_pDAORecordset открытого объекта CDaoRecordset, если вы не знаете внутренних последствий.Можно, однако, использовать интерфейс m_pDAORecordset для вызова DAO непосредственно для получения коллекции полей.В этом случае элемент m_pDAORecordset не может быть изменен.Следует просто должны вызывать Выпуск для объекта коллекции полей после окончания работы с объектом.

Описание вспомогательных обращаться DAO проще.

Вспомогательные, предоставленных и вызова DAO проще те же вспомогательные, предназначенные для внутреннего использования в классах баз данных MFC DAO.Эти вспомогательные используются для проверки коды возврата звоня непосредственно DAO, в файл журнала вывод отладки, допустимых для проверки ошибок и соответствующие при порождении исключения при необходимости.2 Основных вспомогательной функции и 4 макроса, сопоставляют одно из этих 2 вспомогательных.Наилучшее объяснение будет просто чтение кода.В разделе DAO_CHECK, DAO_CHECK_ERROR, DAO_CHECK_MEM и DAO_TRACE в AFXDAO.H для просмотра макросы и см. AfxDaoCheck и AfxDaoTrace в DAOCORE.CPP.

С помощью интерфейсов OLE DAO

Интерфейсов OLE для каждого объекта в иерархии объектов DAO определены в файле заголовка DBDAOINT.H, который находится в папке \ Program Files \ Microsoft Visual Studio .NET 2003 \ VC7 \ include.Эти интерфейсы предоставляют методы, позволяющие управлять всей иерархии DAO.

Для многих методов в интерфейсах DAO потребуется манипулированию объектом BSTR (длина- присоединенную префикса строку, используемую в ole-автоматизацией).Объект BSTR обычно инкапсулированы в тип данных VARIANT.Класс COleVariant представляет собой MFC унаследован от типа данных VARIANT.В зависимости от того откуда выполняется проекта для ANSI или юникода, интерфейсы DAO возвращают ANSI или юникод объектов BSTR.2 Макроса, V_BSTR и V_BSTRT, используются для убеждать, интерфейс DAO получает ожидаемого типа BSTR.

Извлекает элемент V_BSTRbstrValCOleVariant.Этот макрос обычно используется, когда требуется передать содержимое COleVariant в метод интерфейса DAO.В следующем фрагменте кода показано и объявления и фактическое использование для 2 методов интерфейса DAO DAOUser, пользующихся преимуществами макроса V_BSTR:

COleVariant varOldName;
COleVariant varNewName( _T("NewUser"), VT_BSTRT );

// Code to assign pUser to a valid value omitted
DAOUser *pUser = NULL;

// These method declarations were taken from DBDAOINT.H
// STDMETHOD(get_Name) (THIS_ BSTR FAR* pbstr) PURE;
// STDMETHOD(put_Name) (THIS_ BSTR bstr) PURE;

DAO_CHECK( pUser->get_Name( &V_BSTR ( &varOldName ) ));
DAO_CHECK( pUser->put_Name( V_BSTR ( &varNewName ) ));

Обратите внимание, что аргумент VT_BSTRT, указанный в конструкторе COleVariant предыдущем гарантирует, что будет ANSI BSTR в COleVariant при построении версии ANSI приложения и юникод BSTR для юникода версии приложения.Что такое DAO ожидает.

Другой макрос, V_BSTRT извлекает или ANSI или юникода bstrVal член COleVariant в зависимости от типа построения (ANSI или юникод).В следующем примере демонстрируется, как получить значение BSTR из COleVariant в CString:

COleVariant varName( _T( "MyName" ), VT_BSTRT );
CString str = V_BSTRT( &varName );

Макрос V_BSTRT вместе с другими методами, чтобы открыть других типов, которые содержатся в COleVariant, как показано в примере DAOVIEW.В частности, этот преобразование выполняется в методе CCrack::strVARIANT.Этот метод, если это возможно, преобразует значение COleVariant в экземпляр CString.

Простой пример прямого вызова DAO

Могут возникнуть ситуации, когда необходимо обновить базовые объекты коллекции DAO.Обычно это не должно быть обязательным, но простую процедуру, если это необходимо.Пример, когда коллекция может обновлять при работе в многопользовательской среде с нескольких пользователей создания новых tabledefs.В этом случае коллекция tabledefs может быть несвежой.Для обновления коллекции необходимо просто вызвать метод Обновить определенного объекта коллекции и проверить ошибки:

DAO_CHECK( pMyDaoDatabase->
    m_pDAOTableDefs->Refresh( ) );

Обратите внимание, что в данный момент все интерфейсы объекта коллекции DAO незадокументированные подробности реализации классов баз данных MFC DAO.

С помощью классов DAO непосредственно для функций безопасности DAO

Классы баз данных MFC DAO не реализует функции безопасности DAO.Необходимо вызывать методы интерфейсов DAO использовать некоторые функции безопасности DAO.Следующая функция задает базу данных системы и затем изменить пароль пользователя.Этот метод вызывает функции 3 других функций, которая затем определены.

void ChangeUserPassword( )
{
   // Specify path to the Microsoft Access
   // system database
   CString strSystemDB = 
     _T( "c:\\Program Files\\MSOffice\\access\\System.mdw" );

   // Set system database before MFC initilizes DAO
   // NOTE: An MFC module uses only one instance 
   // of a DAO database engine object. If you have 
   // called a DAO object in your application prior 
   // to calling the function below, you must call 
   // AfxDaoTerm to destroy the existing database 
   // engine object. Otherwise, the database engine 
   // object already in use will be reused, and setting
   // a system datbase will have no effect.
   //
   // If you have used a DAO object prior to calling 
   // this function it is important that DAO be 
   // terminated with AfxDaoTerm since an MFC
   // module only gets one copy of the database engine 
   // and that engine will be reused if it hasn't been 
   // terminated. In other words, if you do not call 
   // AfxDaoTerm and there is currently a database 
   // initialized, setting the system database will 
   // have no affect.

   SetSystemDB( strSystemDB );

   // User name and password manually added
   // by using Microsoft Access
   CString strUserName = _T( "NewUser" );
   CString strOldPassword = _T( "Password" );
   CString strNewPassword = _T( "NewPassword" );

   // Set default user so that MFC will be able
   // to log in by default using the user name and 
   // password from the system database
   SetDefaultUser( strUserName, strOldPassword );

   // Change the password. You should be able to
   // call this function from anywhere in your 
   // MFC application
   ChangePassword( strUserName, strOldPassword, 
                   strNewPassword );

   .
   .
   .

}

Следующие 4 примера демонстрируется на:

Задайте базу данных системы DAO (файл .MDW).
Задайте пользователя по умолчанию и пароль.
Измените пароль пользователя.
Измените пароль файла .MDB.

Параметр базы данных система

Функция ниже примера, чтобы установить базу данных системы, которая будет использоваться приложением.Эту функцию необходимо вызывать перед любыми другими DAO выполненные.

// Set the system database that the 
// DAO database engine will use

void SetSystemDB( CString & strSystemMDB )
{
   COleVariant varSystemDB( strSystemMDB, VT_BSTRT );

   // Initialize DAO for MFC
   AfxDaoInit( );
   DAODBEngine* pDBEngine = AfxDaoGetEngine( );

   ASSERT( pDBEngine != NULL );

   // Call put_SystemDB method to set the 
   // system database for DAO engine
   DAO_CHECK( pDBEngine->put_SystemDB( varSystemDB.bstrVal ) );
}

Параметр по умолчанию пользователя и пароль

Чтобы задать пользователя по умолчанию и пароль для базы данных системы используйте следующую функцию:

void SetDefaultUser(CString & strUserName, CString & strPassword)
{
  COleVariant varUserName( strUserName, VT_BSTRT );
  COleVariant varPassword( strPassword, VT_BSTRT );

  DAODBEngine* pDBEngine = AfxDaoGetEngine( );
  ASSERT( pDBEngine != NULL );

  // Set default user:
  DAO_CHECK( pDBEngine->put_DefaultUser( varUserName.bstrVal ) );

  // Set default password:
  DAO_CHECK( pDBEngine->put_DefaultPassword( varPassword.bstrVal ) );
}

Изменение пароля пользователя

Чтобы изменить пароль пользователя, используйте следующую функцию:

void ChangePassword( CString &strUserName, 
                     CString &strOldPassword, 
                     CString &strNewPassword )
{
   // Create (open) a workspace
   CDaoWorkspace wsp;
   CString strWspName = _T( "Temp Workspace" );

   wsp.Create( strWspName, strUserName,
               strOldPassword );
   wsp.Append( );

   // Determine how many objects there are
   // in the Users collection
   short nUserCount;
   short nCurrentUser;
   DAOUser *pUser  = NULL;
   DAOUsers *pUsers = NULL;

   // Side-effect is implicit OLE AddRef( ) 
   // on DAOUser object:
   DAO_CHECK( wsp.m_pDAOWorkspace->get_Users( &pUsers ) );

   // Side-effect is implicit OLE AddRef( ) 
   // on DAOUsers object
    DAO_CHECK( pUsers->get_Count( &nUserCount ) );

   // Traverse through the list of users 
   // and change password for the userid
   // used to create/open the workspace
   for( nCurrentUser = 0; nCurrentUser < nUserCount;
        nCurrentUser++ )
   {
       COleVariant varIndex( nCurrentUser, VT_I2 );
       COleVariant varName;

       // Retrieve information for user nCurrentUser
       DAO_CHECK( pUsers->get_Item( varIndex, &pUser ) );

       // Retrieve name for user nCurrentUser
       DAO_CHECK( pUser->get_Name( &V_BSTR( &varName ) ) );

       CString strTemp = V_BSTRT( &varName );

       // If there is a match, change the password
       if( strTemp == strUserName )
       {
           COleVariant varOldPwd( strOldPassword, 
                                  VT_BSTRT );
           COleVariant varNewPwd( strNewPassword, 
                                  VT_BSTRT );

           DAO_CHECK( pUser->NewPassword( V_BSTR( &varOldPwd ),
                      V_BSTR( &varNewPwd ) ) );

           TRACE( "\t Password is changed\n" );
       }
   }

   // Clean up: decrement the usage count
   // on the OLE objects
   pUser->Release( );
   pUsers->Release( );

   wsp.Close( );
}

Изменение пароля файла .MDB

Чтобы изменить пароль файла .MDB используйте следующую функцию:

void SetDBPassword( LPCTSTR pDB, LPCTSTR pszOldPassword, LPCTSTR pszNewPassword )
{
   CDaoDatabase db;
   CString strConnect( _T( ";pwd=" ) );

   // the database must be opened as exclusive
   // to set a password
   db.Open( pDB, TRUE, FALSE, 
            strConnect + pszOldPassword );

   COleVariant NewPassword( pszNewPassword, VT_BSTRT ),
               OldPassword( pszOldPassword, VT_BSTRT );

   DAO_CHECK( db.m_pDAODatabase->NewPassword( V_BSTR( &OldPassword ),
              V_BSTR( &NewPassword ) ) );

   db.Close();
}

См. также

Другие ресурсы

Технические замечания по номеру

Технические замечания по категориям

Поделиться через