1 前言

　　隨著UG系統(tǒng)的推廣和普及應(yīng)用，基于UG平臺(tái)的二次開(kāi)發(fā)工作顯得越來(lái)越重要，在UG的二次開(kāi)發(fā)應(yīng)用系統(tǒng)中，經(jīng)常需要與各種外部數(shù)據(jù)打交道， UG/OPEN API提供了豐富的文件訪問(wèn)操作函數(shù)，利用這些操作函數(shù)及VC++的MFC類(lèi)庫(kù)，可以方便地實(shí)現(xiàn)外部數(shù)據(jù)讀寫(xiě)訪問(wèn)編程。

　　2 外部數(shù)據(jù)訪問(wèn)的主要方法

　　在UG二次開(kāi)發(fā)應(yīng)用系統(tǒng)中，主要訪問(wèn)的外部數(shù)據(jù)有文本文件、Excel表、關(guān)系型數(shù)據(jù)庫(kù)表等，通常可以通過(guò)以下方法訪問(wèn)這些外部數(shù)據(jù)：

　　(1)通過(guò)UG/OPEN API提供的文件操作函數(shù)訪問(wèn)外部數(shù)據(jù)

　　(2)通過(guò)ODBC數(shù)據(jù)源訪問(wèn)外部數(shù)據(jù)

　　(3)通過(guò)ADO訪問(wèn)外部數(shù)據(jù)

　　2.1 通過(guò)UG/OPEN API提供的文件操作函數(shù)訪問(wèn)文本文件數(shù)據(jù)

　　UG/OPEN API中有關(guān)文件操作的函數(shù)包含在頭文件uf_cfi.h中，通過(guò)函數(shù)uc4500可以打開(kāi)二進(jìn)制文件，相關(guān)的文件操作函數(shù)有uc4510、uc4511、uc4512、uc4513及uc4520、uc4521、uc4522、uc4523，通過(guò)函數(shù)uc4504可以打開(kāi)文本文件，相關(guān)的文件操作函數(shù)有uc4514、uc4524、uc4525，函數(shù)uc4540用于關(guān)閉文件，判斷文件是否存在使用函數(shù)UF_CFI_ask_file_exist。

　　通過(guò)UG/OPEN API提供的文件操作函數(shù)訪問(wèn)外部數(shù)據(jù)時(shí)，要注意以下問(wèn)題：

　　(1)UG/Manager 和 IMAN中的文件和文件夾操作不能使用uf_cfi.h中函數(shù);

　　(2)UG/OPEN API中對(duì)文件和文件夾標(biāo)識(shí)符的長(zhǎng)度有如下限制：

　　文件名長(zhǎng)度不能超過(guò)UF_CFI_MAX_FILE_NAME_LEN;文件夾路徑的長(zhǎng)度不能超過(guò)UF_CFI_MAX_PATH_NAME_LEN;整個(gè)文件路徑的長(zhǎng)度不能超過(guò)UF_CFI_MAX_PATH_NAME_LEN。

　　訪問(wèn)文本文件的程序流程如下圖：

　　2.2 通過(guò)ODBC數(shù)據(jù)源訪問(wèn)Excel表或關(guān)系型數(shù)據(jù)庫(kù)表數(shù)據(jù)

　　ODBC(Open Database connectivity 開(kāi)放式數(shù)據(jù)庫(kù)互連)是由微軟公司提出的一個(gè)用于訪問(wèn)數(shù)據(jù)庫(kù)的統(tǒng)一界面標(biāo)準(zhǔn)，它提供了一個(gè)一致的應(yīng)用程序編程接口，該接口使用一個(gè)針對(duì)數(shù)據(jù)庫(kù)的驅(qū)動(dòng)程序與不同的數(shù)據(jù)庫(kù)協(xié)同工作。

　　通過(guò)ODBC訪問(wèn)外部數(shù)據(jù)時(shí)，需要先指定訪問(wèn)的數(shù)據(jù)源DSN(Data Source Name)，以指定ODBC與相關(guān)的驅(qū)動(dòng)程序相對(duì)應(yīng)的入口。在控制面板的管理工具中可以打開(kāi)ODBC數(shù)據(jù)源管理器，指定DSN。

　　建立MFC數(shù)據(jù)庫(kù)類(lèi)Cdatabse對(duì)象可以實(shí)現(xiàn)對(duì)外部數(shù)據(jù)的訪問(wèn)編程。一個(gè)CDatabase對(duì)象代表與數(shù)據(jù)源的一個(gè)連接。創(chuàng)建一個(gè)CDatabase對(duì)象之后，調(diào)用Open或OpenEx成員函數(shù)指定一個(gè)DSN，就建立起了與DSN的底層數(shù)據(jù)源的連接(打開(kāi)數(shù)據(jù)庫(kù))。成員函數(shù)Close關(guān)閉數(shù)據(jù)庫(kù)。CDatabase對(duì)象通常與一個(gè)或多個(gè)記錄集(CRecordset對(duì)象)一起使用，通過(guò)CRecordset類(lèi)的各成員函數(shù)完成對(duì)數(shù)據(jù)源的讀寫(xiě)操作。

　　通過(guò)ODBC訪問(wèn)一個(gè)Excel表的編程實(shí)例代碼如下：

　　static void do_ugopen_api(void)

　　{

　　CDatabase Database; // 定義一個(gè)MFC的CDatabse數(shù)據(jù)庫(kù)類(lèi)對(duì)象Databse

　　CString SQLCommand = "select `Serial_Number`, `Outer_Diameter`, `Inner_Diameter`,`Height` from `Sheet1$`"; // SQL查詢語(yǔ)句

　　DWORD dwOptions = 0;// 設(shè)置連接的建立方式

　　CDBVariant temp;// 數(shù)據(jù)庫(kù)數(shù)據(jù)通用類(lèi)型

　　int result; // 儲(chǔ)存返回值的變量

　　char buf[133];

　　try

　　{

　　result = Database.OpenEx( "DSN=Standard Part", dwOptions ); // 打開(kāi)數(shù)據(jù)庫(kù)

　　if( result != 0 ) // 如果成功打開(kāi)

　　{

　　CRecordset rs( &Database ); // 定義記錄集

　　if ( rs.Open( CRecordset::snapshot, SQLCommand ) != false )

　　{

　　rs.MoveFirst( );

　　short nFields = rs.GetODBCFieldCount( );// 獲取記錄的字段數(shù)目

　　UF_UI_open_listing_window( );

　　while( !rs.IsEOF( ) )

　　{

　　for( short index = 1; index < nFields; index++ )

　　{

　　rs.GetFieldValue( index, temp );

　　sprintf(buf,"%f",temp.m_dblVal );

　　UF_UI_write_listing_window(buf );

　　UF_UI_write_listing_window( "t" );

　　}

　　UF_UI_write_listing_window( " " );

　　rs.MoveNext( );

　　}

　　rs.Close( );// 關(guān)閉記錄集

　　}

　　Database.Close(); // 關(guān)門(mén)數(shù)據(jù)庫(kù)連接

　　}

　　}

　　catch( CDBException *pe ) // 出錯(cuò)處理

　　{

　　AfxMessageBox( "Exception!" );

　　AfxMessageBox( pe->m_strError );

　　pe -> Delete( );

　　}

　　}

　　2.3 通過(guò)ADO訪問(wèn)外部數(shù)據(jù)

　　ADO(ActiveX Data Objects)是微軟的數(shù)據(jù)庫(kù)對(duì)象技術(shù)，ADO里面包括連接數(shù)據(jù)庫(kù)的對(duì)象，從查詢語(yǔ)句中返回?cái)?shù)據(jù)的記錄集對(duì)象和表現(xiàn)數(shù)據(jù)元素的字段對(duì)象。支持ADO編程的庫(kù)文件是msado15.dll，它默認(rèn)保存在“c:program filescommon silessystemado”目錄下，動(dòng)態(tài)鏈接庫(kù)msado15.dll封裝了ADO的所有功能。在默認(rèn)情況下，Visual C++不支持ADO對(duì)象。要在程序中使用ADO對(duì)象，需要使用#import命令將ADO庫(kù)文件導(dǎo)入到工程中，代碼如下：

　　#import “c:Program FilesCommon FilesSystemadomsado15.dll” no_namespace rename(“EOF”,”adoEOF”) rename(“BOF”,”adoBOF”)

　　參數(shù)no_namespace 表示不使用ADO的名字空間。為了避免出現(xiàn)常量名沖突，需要將EOF改名為adoEOF、BOF改名為adoBOF。

　　ADO庫(kù)包含3個(gè)基本接口，即_ConnectionPtr接口、_CommandPtr接口和_RecordsetPtr接口。它們分別對(duì)應(yīng)Connection對(duì)象、Command對(duì)象和Recordset對(duì)象。通過(guò)這三個(gè)基本接口可實(shí)現(xiàn)對(duì)數(shù)據(jù)庫(kù)的訪問(wèn)。

　　通過(guò)ADO訪問(wèn)數(shù)據(jù)庫(kù)的一般步驟如下：

　　(1)連接到數(shù)據(jù)源;

　　(2)指定訪問(wèn)數(shù)據(jù)源的命令(查詢、更新、刪除等操作命令);

　　(3)執(zhí)行命令。

　　有關(guān)ADO庫(kù)基本接口的使用方法請(qǐng)參見(jiàn)相關(guān)的參考手冊(cè)，下面給出通過(guò)ADO訪問(wèn)Access數(shù)據(jù)庫(kù)表的實(shí)例程序代碼段：

　　bool DoAdoTest( void )

　　{

　　// 初始化對(duì)COM的調(diào)用

　　CoInitialize( 0 );

　　_ConnectionPtr pConnection = NULL; // 連接

　　_RecordsetPtr pRecordset = NULL; // 記錄集

　　HRESULT hr = E_UNEXPECTED;

　　CString strConnectionString( "Provider=Microsoft.Jet.OLEDB.4.0;Data 落Source=f:\ug\chapter3_4\screw.mdb" ); // 連接字符串

　　CString strSqlCommandString( "SELECT * From screw_table " ); // SQL語(yǔ)句

　　pConnection.CreateInstance( __uuidof( Connection ) ); // ( "ADODB.Connection" );

　　pRecordset.CreateInstance( __uuidof( Recordset ) ); // ( "ADODB.Recordset" );

　　try

　　{ hr = pConnection->Open( ( _bstr_t )strConnectionString, "", "", adModeUnknown ); // 連接數(shù)據(jù)庫(kù)

　　MessageBox( NULL, "連接數(shù)據(jù)庫(kù)成功!", "提示", MB_OK | MB_ICONINFORMATION );

　　}

　　catch ( _com_error e )

　　{

　　MessageBox( NULL, "連接數(shù)據(jù)庫(kù)失敗!", "錯(cuò)誤", MB_OK | MB_ICon ERROR );

　　return false;

　　}

　　try

　　{

　　hr = pRecordset->Open( ( _bstr_t )strSqlCommandString,

　　_variant_t((IDispatch*)pConnection,true),

　　adOpenStatic,

　　adLockOptimistic,

　　adCmdText ); // 獲取記錄集

　　}

　　catch ( _com_error* e )

　　{

　　e->ErrorMessage();

　　MessageBox( NULL, "打開(kāi)記錄集失敗!", "錯(cuò)誤", MB_OK | MB_ICon ERROR );

　　}

　　CString tmp;

　　UF_UI_open_listing_window();

　　// 輸出字段名

　　long lFieldsCount = -1;

　　lFieldsCount = pRecordset->GetFields()->Count;

　　for ( long i = 0; i < lFieldsCount; i++ )

　　{

　　tmp.Format( "%-7s", ( LPCSTR )pRecordset->GetFields()->Item[ i ]->Name );

　　UF_UI_write_listing_window( ( LPTSTR )( LPCSTR )tmp );

　　UF_UI_write_listing_window( "t" );

　　}

　　UF_UI_write_listing_window( " " );

　　// 輸出所有記錄

　　pRecordset->MoveFirst();

　　while(!pRecordset->adoEOF)

　　{

　　tmp = pRecordset->GetCollect( 0L );

　　UF_UI_write_listing_window( ( LPTSTR )( LPCSTR )tmp );

　　……//輸出記錄中其他字段值

　　pRecordset->MoveNext();

　　}

　　pRecordset->Close();

　　pRecordset = NULL;

　　pConnection->Close();

　　pConnection = NULL;

　　CoUninitialize();

　　return true;

　　}

　　3 結(jié)論

　　在UG二次開(kāi)發(fā)過(guò)程中，確定選擇哪種方法訪問(wèn)外部數(shù)據(jù)，取決于具體的應(yīng)用系統(tǒng)要求。通過(guò)UG/OPEN API編程較適合于對(duì)外部文本文件的訪問(wèn)，可方便實(shí)現(xiàn)用戶與UG信息窗口交互等功能;通過(guò)ODBC和ADO技術(shù)可以訪問(wèn)各種支持的數(shù)據(jù)源，包括文本文件、Excel表及各種關(guān)系型數(shù)據(jù)庫(kù)表等，ADO與ODBC相比，使用更加簡(jiǎn)便，免去了繁瑣的配置數(shù)據(jù)源工作，但有些數(shù)據(jù)庫(kù)僅支持ODBC，不直接支持ADO數(shù)據(jù)庫(kù)技術(shù)。