UG二次开发外部数据使用

　　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数据库技术。