1 前言

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

　　2 外部數據訪問的主要方法

　　在UG二次開發應用系統中，主要訪問的外部數據有文本文件、Excel表、關系型數據庫表等，通常可以通過以下方法訪問這些外部數據：

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

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

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

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

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

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

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

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

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

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

　　2.2 通過ODBC數據源訪問Excel表或關系型數據庫表數據

　　ODBC(Open Database connectivity 開放式數據庫互連)是由微軟公司提出的一個用于訪問數據庫的統一界面標準，它提供了一個一致的應用程序編程接口，該接口使用一個針對數據庫的驅動程序與不同的數據庫協同工作。

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

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

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

　　static void do_ugopen_api(void)

　　{

　　CDatabase Database; // 定義一個MFC的CDatabse數據庫類對象Databse

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

　　DWORD dwOptions = 0;// 設置連接的建立方式

　　CDBVariant temp;// 數據庫數據通用類型

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

　　char buf[133];

　　try

　　{

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

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

　　{

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

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

　　{

　　rs.MoveFirst( );

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

　　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( );// 關閉記錄集

　　}

　　Database.Close(); // 關門數據庫連接

　　}

　　}

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

　　{

　　AfxMessageBox( "Exception!" );

　　AfxMessageBox( pe->m_strError );

　　pe -> Delete( );

　　}

　　}

　　2.3 通過ADO訪問外部數據

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

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

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

　　ADO庫包含3個基本接口，即_ConnectionPtr接口、_CommandPtr接口和_RecordsetPtr接口。它們分別對應Connection對象、Command對象和Recordset對象。通過這三個基本接口可實現對數據庫的訪問。

　　通過ADO訪問數據庫的一般步驟如下：

　　(1)連接到數據源;

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

　　(3)執行命令。

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

　　bool DoAdoTest( void )

　　{

　　// 初始化對COM的調用

　　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 ); // 連接數據庫

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

　　}

　　catch ( _com_error e )

　　{

　　MessageBox( NULL, "連接數據庫失敗!", "錯誤", 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 結論

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