使用C#调用PI-SDK进行基于PI的开发.doc

本文引至 明月清风伴我行 的空间使用C#调用PI-SDK进行基于PI的开发（一）PI-SDK简介一、概述PI-SDK（Plant Information Software Develop Kit）是OSI公司提供的基于面向对象的访问PI数据库的软件开发工具包，它可以对以下数据库进行读写： PIPoints(PI point table) StateSets(Digital sets table) PIUsers(User table) PIGroups(Groups table) PIModuleDB (Modules Database) PIBatchDB (Batches Database) PITransferRecords (TransferRecords Database) Point Classes (Attribute Sets)PI SDK只有在32位Windows平台下可以使用，可以调用任何平台下的PI数据库。二、PI-SDK对象继承图在这个对象继承图中，本人用得最多的是PIPoint了，所以，大家现在先清楚PISDK-Servers-Server- PIPoints-PIPoint这一条线，其它的以后我们再慢慢叙述。三、关于“About PI-SDK”程序当PI-SDK安装完成后，可以在如下目录下找到此应用程序：PIPCPISDKAboutPI SDK.exe通过这个应用程序可以查看PI-SDK的版本号，以及维护已知服务器列表（known servers list），测试与服务器列表中的各个服务器是否能正常连接（如下图所示，本地服务器localhost可以正常连接）。单击 Connections四、PI-SDK和PI-API的比较项目PI-APIPI-SDK全称PI Application Programming Interface，PI应用程序接口PI Software Development Kit，PI软件开发工具包面向procedural methods，面向编程Object-oriented对象编程安装完成后创建目录(pipc, pipcdat, pipcbin, pipclibrary, and pipcinclude)，在WindowsSystem32目录下创建文件piapi32.dll和pilog32.dllpipcPISDK支持平台所有平台支持API调用的所有语言，如(VB, VBA, C, Fortran, Delphi,.)Windows平台支持面向对象的语言使用C#调用PI-SDK进行基于PI的开发（二）使用PI-SDK建立与PI数据库的连接（1）一、关于known servers list（已知服务器列表）PI-SDK创建和维护known servers lists（已知服务器列表）；PI-API使用和维护PIPCDATPILOGIN.INI中的服务器表。对PILOGIN.INI服务器表的修改会自动更新到PI-SDK的known servers lists中；而PI-SDK对known servers list的修改不会自动更新到PILOGIN.INI中。在使用PI-SDK时，如果需要连接的PI服务器不在known servers lists中，则应首先将它加入到known servers lists中。二、连接PI服务器的两种方式1、 以互动方式登陆通过用户名和密码登陆互动方式登陆有3种方式：a) PISDK.Server.Open(string connectstring)ConnectionString为连接字符串，为string数据类型。它的格式如下：UID=PIUser;PWD=PIUserPassWord其中PIUser为PI用户名，PIUserPassWord为对应PI用户的密码，如果无密码则用空字符串。例如，如果用户为piadmin，对应的密码为123，则对应的连接字符串为：UID=piadmin;PWD=123b) PISDKDlg.Connections.Login(ref PISDK.Server PIServer, ref string PIUser, ref string Password, bool Override, bool ForceShow)具体调用方法在实例中会进一步说明。这个方法本人还不太会用，主要对Override和ForceShow的含义不太清楚（我试了一下，当Override为false，ForceShow为true时，程序会出错）。有会用这个方法的请告知。3）PISDKDlg.Connections.ShowConnectionDialog（bool ReadOnly, short Modal）使用这个方法会调用PI连接管理器对话框（PI Connection Manager dialog）。PI连接管理器会列出已知服务器表（Known Servers table）中的所有PI服务器，并且可以对PI服务器进行连接和断开连接、在已知服务器列表中添加和删除PI服务器、更改默认连接参数、定义服务器ID别名和路径别名等操作。2、 以非互动方式登陆借用trust登陆PISDK.Server.Open(string.Empty)具体代码见代码示例。三、连接到PI窗口应用程序本实例建立一个Windows Form应用程序，其中包括了1个GroupBox控件、3个Label控件、1个ListBox控件、3个Button控件、2个TextBox控件，具体界面通过“Es