piafsdk研究.docxVIP

PI AFSDK分类汇总1.概述AF SDK是一个.NET集成开发包，它用于为用户提供对OSIsoft数据的结构化访问。AF SDK提供了一种与OSIsoft数据库实现数据交互的方法，它可以与PI-SDK以及PI-API配合使用。AF SDK设计目的是为VB,C#以及Managed C++提供方便的访问路径。AF SDK可呈现出对象层次分明的模型。AF SDK包括11个namespace，如图1所示：图1每个namespace的总体功能说明如下：NamespaceDescriptionOSIsoft.AFPISystems集位于AF SDK层级中的第一层，大多数访问AF对象的路径都以它为起始引用。此类型对象的多数实例都可以在应用程序中创建，但是在同一个应用中，同一个用户所有的实例都引用相同的PISystem对象，也就意味着：在同一个应用中，对于某一个属于此PISystem类对象的所有操作都会被所有该PISystem类型对象的实例所见。而其他应用则直到这些操作被保存时才能看到。在VB或C#中，首层对象可以利用对象名前加OSIsoft.AF的方法来引用，如：OSIsoft.AF.PISystem。OSIsoft.AF.Analysis该namespace提供了一系列用于创建、安排及执行分析操作的类。OSIsoft.AF.Asset该namespace提供了一系列可用于代表某机构（或团体）中各资产的类。它允许创建各资产及其属性的层级关系。另外，它提供了用于处理常见请求（如远程数据访问、计量单位换算及定义和执行资产定义等）的功能特性，每个PISystem都由任意多个相互独立的数据库组成。OSIsoft.AF.Collective该namespace提供了一系列用于管理AF 高可用（HF）服务器集的类OSIsoft.AF.Diagnostics该namespace提供了一系列具有诊断功能的类OSIsoft.AF.EventFrame该namespace提供了一系列类，这些类可用于创建具有起效时间和结束时间的对象。OSIsoft.AF.Modeling该namespace提供了一系列用于创建工厂资产或（工业）过程模型的类OSIsoft.AF.Notification该namespace提供了一系列用于创建告警的类，告警作用是通知用户事件的发生OSIsoft.AF.Search该namespace提供了一系列可用于创建、存储及执行有哪些信誉好的足球投注网站任务的类。OSIsoft.AF.Time该namespace提供了一系列与时间功能相关的类OSIsoft.AF.UnitsOfMeasure该namespace提供了一系列类，这些类可用于定义计量单位系统，此计量单位系统可以描述属性或数值的单位并完成从一种单位到另一种单位的转换。在PISystem中，一个计量单位数据库被所有的数据库所共享。每个namespace中不仅仅包含多个类，还包括接口、结构体以及事件等，每个类、接口等又有各自的成员（members），如类的members具体有构造函数constructors、方法methods、符号operators、属性properties及事件events。，具体如图2 所示（注：并不是每个namespace都具有图中所有的内容）。下文将按照namespace Classclass membersdelegatesdelegates membersstructuresstructures membersinterfacesinterfaces membersenumerationsenumerations members的顺序进行介绍。2.各OSIsoft.AF Namespace分析。2.1 OSIsoft.AF Namespace2.1.1 OSIsoft.AF Namespace中的类Class2.1.1.1各类综述ClassDescriptionAFActiveDirectoryProperties该类的对象用于获取及设置活动路径配置属性（Active Directory configuration properties），AF Server需根据此属性值获取contact信息。AFCategoriesAF AFCategory 集。AF数据库（Database）对象负责维护在该数据库上定义的所有AFCategoty集。AFCategoryAFCategory代表一个用户自定义的数值，它用于将AF SDK内的对象进行分类。当形成报告或做查询时，AFCategory将对象按照类型进行分组AFChangedEventArgs为被修改的事件提供数据AFCheckOutInfo该类的对象用于表示当前对象的签出状态信息。AFCollectionAF SDK中所有集合的