1 前言

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

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

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

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

　　(2)通過ODBC數(shù)據(jù)源訪問外部數(shù)據(jù)

　　(3)通過ADO訪問外部數(shù)據(jù)

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

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

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

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

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

　　文件名長度不能超過UF_CFI_MAX_FILE_NAME_LEN;文件夾路徑的長度不能超過UF_CFI_MAX_PATH_NAME_LEN;整個文件路徑的長度不能超過UF_CFI_MAX_PATH_NAME_LEN。

　　訪問文本文件的程序流程如下圖：

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

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

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

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

　　通過ODBC訪問一個Excel表的編程實例代碼如下：

　　static void do_ugopen_api(void)

　　{

　　CDatabase Database; // 定義一個MFC的CDatabse數(shù)據(jù)庫類對象Databse

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

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

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

　　int result; // 儲存返回值的變量

　　char buf[133];

　　try

　　{

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

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

　　{

　　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)門數(shù)據(jù)庫連接

　　}

　　}

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

　　{

　　AfxMessageBox( "Exception!" );

　　AfxMessageBox( pe->m_strError );

　　pe -> Delete( );

　　}

　　}

　　2.3 通過ADO訪問外部數(shù)據(jù)

　　ADO(ActiveX Data Objects)是微軟的數(shù)據(jù)庫對象技術(shù)，ADO里面包括連接數(shù)據(jù)庫的對象，從查詢語句中返回數(shù)據(jù)的記錄集對象和表現(xiàn)數(shù)據(jù)元素的字段對象。支持ADO編程的庫文件是msado15.dll，它默認(rèn)保存在“c:program filescommon silessystemado”目錄下，動態(tài)鏈接庫msado15.dll封裝了ADO的所有功能。在默認(rèn)情況下，Visual C++不支持ADO對象。要在程序中使用ADO對象，需要使用#import命令將ADO庫文件導(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庫包含3個基本接口，即_ConnectionPtr接口、_CommandPtr接口和_RecordsetPtr接口。它們分別對應(yīng)Connection對象、Command對象和Recordset對象。通過這三個基本接口可實現(xiàn)對數(shù)據(jù)庫的訪問。

　　通過ADO訪問數(shù)據(jù)庫的一般步驟如下：

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

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

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

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

　　bool DoAdoTest( void )

　　{

　　// 初始化對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語句

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

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

　　try

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

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

　　}

　　catch ( _com_error e )

　　{

　　MessageBox( NULL, "連接數(shù)據(jù)庫失敗!", "錯誤", 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, "打開記錄集失敗!", "錯誤", 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二次開發(fā)過程中，確定選擇哪種方法訪問外部數(shù)據(jù)，取決于具體的應(yīng)用系統(tǒng)要求。通過UG/OPEN API編程較適合于對外部文本文件的訪問，可方便實現(xiàn)用戶與UG信息窗口交互等功能;通過ODBC和ADO技術(shù)可以訪問各種支持的數(shù)據(jù)源，包括文本文件、Excel表及各種關(guān)系型數(shù)據(jù)庫表等，ADO與ODBC相比，使用更加簡便，免去了繁瑣的配置數(shù)據(jù)源工作，但有些數(shù)據(jù)庫僅支持ODBC，不直接支持ADO數(shù)據(jù)庫技術(shù)。