西门子DP电缆经销授权代理商
国际化工业自动化科技产品供应商，西门子G120、G120C V20 变频器； S120 V90 伺服控制系统；6EP电源；电线；电缆；
网络交换机；工控机等工业自动化的设计、技术开发、项目选型安装调试等相关服务是专业从事工业自动化控制系统、机电一体化装备和信息化软件系统
集成和硬件维护服务的综合性企业。与西门子品牌合作，只为能给中国的客户提供值得信赖的服务体系，我们
的业务范围涉及工业自动化科技产品的设计开发、技术服务、安装调试、销售及配套服务领域。建立现代化仓
储基地、积累充足的产品储备、引入万余款各式工业自动化科技产品，我们以持续的卓越与服务，取得了年销
售额10亿元的佳绩，凭高满意的服务赢得了社会各界的好评及青睐。其产品范围包括西门子S7-SMART200、 S7-200CN、S7-300、S7-400、S7-1200、S7-1500、S7-ET200SP 等各类工业自动化产品。西门子授权代理商、西门子一级代理商 西门子PLC模块代理商﹐西门子模块代理商供应全国范围：
与此同时，我们还提供。
西门子中国授权代理商—— 浔之漫智控技术（上海）有限公司，本公司坐落于松江工业区西部科技园，西边和全球zhuming芯片制造商台积电毗邻，
东边是松江大学城，向北5公里是佘山国家旅游度假区。轨道交通9号线、沪杭高速公路、同三国道、松闵路等
交通主干道将松江工业区与上海市内外连接，交通十分便利。
目前，浔之漫智控技术（上海）有限公司将产品布局于中、高端自动化科技产品领域，
PLC模块S7-200、S7-1200、S7-300、S7-400、ET200分布式I/O等
HMI触摸屏、SITOP电源、6GK网络产品、ET200分布式I/O SIEMENS 驱动产品MM系列变频器、G110 G120变频器、直流调速器、电线电缆
仅当用户选择的导出选项为“ExportOptions.WithReadOnly”时，才会导出 SimaticMLAccess
只读的属性。
程序代码
修改以下程序代码以导出版本内容信息：
Guid g = new Guid("35ad9996-d6d7-40c9-989f-0f0c7e21a7b2");
//Block1
var version = m_Project.ProjectLibrary.FindType(g).Versions[0];
version.Export(new FileInfo(@"D:\ExportCodeBlock.xml"),ExportOptions.WithReadOnly);
参见
连接到 TIA Portal (页 82)
打开项目 (页 122)
5.6.13 访问实例
要求
• TIA Portal Openness 应用程序已连接到 TIA Portal。
请参见连接到 TIA Portal (页 82)
• 已通过 TIA Portal Openness 应用程序打开一个项目。
请参见 打开项目 (页 122)
• 您具有所需库的访问权限。
请参见访问全局库 (页 200)。
• 您具有类型组的访问权限。
请参见在库中访问文件夹 (页 212)。
应用
可通过 TIA Portal Openness API 接口访问类型版本的实例使用 FindInstances(IInstanceSearchScope searchScope) 方法找到某一类型
版本的所有实例。
您可使用 searchScope 参数指定要搜索的项目区域。以下类实现
IInstanceSearchScope 接口，并可用于进行实例搜索：
• PlcSoftware
• HmiTarget
此方法会返回一个列表，其中包含 LibraryTypeInstanceInfo 类型的对象。如果未使
用任何实例，则将返回一个空列表。
说明
HMI 用户数据类型和面板的实例通常链接到关联的类型版本。
所有其它对象的实例（例如程序块或画面）可链接到某个类型版本。
枚举一个类型版本的多个实例
修改以下程序代码：
//Enumerate the instances of a type version in the project
LibraryTypeVersion version = ...;
PlcSoftware plcSoftware = ...;
IInstanceSearchScope searchScope = plcSoftware as IInstanceSearchScope;
if(searchScope==null)
{
//No search possible
}
IListinstanceInfos = version.FindInstances(searchScope);
IEnumerableinstances = instanceInfos.Select(instanceInfo =>
instanceInfo.LibraryTypeInstance);
从某个实例导航至其所连接的版本对象
使用 LibraryTypeInstanceInfo 服务的 LibraryTypeVersion 属性从某个实例导航至其所连接的
以下对象可提供 LibraryTypeInstanceInfo 服务：
• 块 FB
• 块 FC
• PLC 用户数据类型
• 画面
• VB 脚本
如果某个实例对象未连接至版本对象，则将不会提供“LibraryTypeInstanceInfo”服务。
FC fc = ...;
//Using LibraryTypeInstanceInfo service
LibraryTypeInstanceInfo instanceInfo = fc.GetService();
if(instanceInfo != null)
{
LibraryTypeVersion connectedVersion = instanceInfo.LibraryTypeVersion;
FC parentFc = instanceInfo.LibraryTypeInstance as FC; //parentFc == fc
}
5.6.14 访问主副本
要求
• TIA Portal Openness 应用程序已连接到 TIA Portal。
请参见连接到 TIA Portal (页 82)
• 已打开一个项目。
请参见打开项目 (页 122)
• 您具有所需库的访问权限。
请参见访问全局库 (页 200)TIA Portal Openness API 接口支持对全局库和项目库中的主副本进行访问：
• 创建主副本
• 枚举系统文件夹和用户定义文件夹中的主副本
• 重命名主副本
• 查询主副本中的信息
• 查询主副本中对象的信息
属性 数据类型 说明
Author String 返回作者的姓名。
ContentDescriptio
ns
MasterCopyContentDescriptionComposition
返回 MasterCopy 内容的说明。
CreationDate DateTime 返回创建日期。
Name String 返回主副本的名称。
程序代码
修改以下程序代码以枚举某一库系统文件夹中的所有主副本：
public static void EnumerateMasterCopiesInSystemFolder
(MasterCopySystemFolder masterCopySystemFolder)
{
foreach (MasterCopy masterCopy in masterCopySystemFolder.MasterCopies)
{
//...
}
}
修改以下程序代码以通过查找方法访问单个主副本
从主副本创建对象
要求
• TIA Portal Openness 应用程序已连接到 TIA Portal。
请参见连接到 TIA Portal (页 82)
• 已打开一个项目。
请参见打开项目 (页 122)
• PLC 未处于在线状态。
应用
TIA Portal Openness API 接口支持在项目中使用主副本。可使用 CreateFrom 方法从项目库
或全局库中的主副本在对象的组成中创建对象。
返回类型与相应组成的返回类型相对应。
CreateFrom 方法仅支持包含单个对象的主副本。如果调用操作的组成与源文件主副本不兼容
（例如，源文件主副本包含 plc 变量表，而组成是 plc 块组成），将发生可恢复的异常。
支持以下组成：
• Siemens.Engineering.HW.DeviceCompositionTIA Portal Openness API 接口支持在库内复制主副本，也可使用 CreateFrom 操作在多个库
之间复制主副本。该操作会创建一个基于新对象的源主副本，并将它置于调用该操作的组合
中。该操作试图创建具有与源主副本相同名称的新主副本。如果该名称不可用，系统将为新
主副本提供一个新名称。随后即可返回新主副本。
如果调用“CreateFrom”操作的组合位于只读全局库中，会出现可恢复的异常情况。
程序代码
修改以下程序代码：
ProjectLibrary projectLibrary = ...;
MasterCopy copiedMasterCopy =
projectLibrary.MasterCopyFolder.MasterCopies.CreateFrom(sampleMasterCopy)
参见
访问主副本 (页 227)
5.6.18 确定过期类型实例
要求
• TIA Portal Openness 应用程序已连接到 TIA Portal。
请参见连接到 TIA Portal (页 82)
• 已打开一个项目。
请参见打开项目 (页 122)
• 您具有所需库的访问权限。
请参见访问全局库 (页 200)
• 您具有类型文件夹的访问权限。
TIA Portal Openness API 接口可用于确定已打开项目中的实例下属的类型版本。TIA Portal
Openness API 将为每个实例返回以下两种状态之一：
• 该实例引用了过期的类型版本。
• 该实例引用的是最新的类型版本。
确定版本时，以下规则适用：
• 版本的确定取决于相关库和要通过 TIA Portal Openness API 接口打开的项目。
• 确定版本时，实例不会进行更新。
签名
使用 UpdateCheck 方法确定实例对应的类型版本：
UpdateCheck(Project project, UpdateCheckMode updateCheckMode)
参数 功能
Project 指定在其中确定实例对应类型版本的具体项目。
UpdateCheckMode 指定确定的版本：
• ReportOutOfDateOnly：仅返回“已过期”(out of date) 类型
的状态。
• ReportOutOfDateAndUpToDate：
返回“已过期”(out of date) 和“最新”(up to date) 类型的状态。
结果
确定版本时会从上至下扫描项目的所有设备。每个设备都将进行检查，以确定其组态数据是
否包含指定库中类型版本的实例。UpdateCheck 方法将以层级结构的顺TIA Portal Openness API 接口可用于在项目的类型文件夹中更新所选类型的实例。
进行更新时，项目中所用的实例将根据最新发布的类型版本进行更新。如果要更新全局库中
的实例，则应预先执行同步操作。
签名
使用 UpdateProject 方法可更新实例。
针对实现 LibraryTypes 接口的类使用以下调用：
void UpdateProject(IUpdateProjectScope updateProjectScope)
针对实现 ILibrary 接口的类使用以下调用：
void UpdateProject(IEnumerableselectedTypesOrFolders, IEnumerableupdateProjectScope)
每个调用都输入在项目目录的日志文件中。
参数 功能
IEnumerableselectedTypesOrFolders
指定要同步的文件夹或类型或者待更新项目
中的相应实例。
IUpdateProjectScope
updateProjectScope
IEnumerableupdateProjectScope
在要更新其中实例的用途的项目中，指定项
目对象。支持以下对象：
• PlcSoftware
• HmiTarge