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( "n" );
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_ICONERROR );
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_ICONERROR );
}
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( "nn" );
// 輸出所有記錄
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數據庫技術。

[參考文獻]
[1] 董正衛，田立中，付宜利.UG/OPEN API編程基礎[M].北京：清華大學出版社，2002.
[2] UGS公司UG/OPENAPIReference.1997.
[3] David J.Kruglinski. Visual C++ 技術內幕[M] .北京：清華大學出版社，2001.