用途:为使用 TIA Portal Openness V21 的 C# 开发提供公共基础参考,覆盖程序集结构、命名空间、加载方式与基本 API 用法。资料声明其为内部参考技能,不应直接从用户查询加载。
主要能力:说明 V21 采用模块化程序集架构(如 Siemens.Engineering.Base.dll 必选,Step7、WinCC、Startdrive、Safety 等按需引用),列出常用命名空间及其用途;此外还包含独立 Openness 应用的程序集加载(AssemblyResolve 与 app.config)说明、TiaPortal 实例化与附加方式、GetService<T>() 服务、事件处理、认证与独占访问。
使用方式:独立应用需在引用任何 Openness 类型前注册 AssemblyResolve,推荐在 Program 静态构造函数注册,并将 Openness 代码放到独立类;程序集引用需 Copy Local 设为 False。实例化示例:using (TiaPortal tiaPortal = new TiaPortal(TiaPortalMode.WithUserInterface)),另有 WithoutUserInterface 无界面模式;附加运行实例可用 TiaPortal.GetProcesses().First().Attach()。服务通过 tiaPortal.GetService<T>() 获取,如 MessageBoxProvider、ProgressProvider、FeedbackProvider,但这些服务仅在 Add-In 运行时可用,且 Add-In 状态回调中返回 null。事件包含 Disposed、Notification、Confirmation、Authentication,需在 finally 中取消订阅;Confirmation 必须设置 "Yes"、"YesToAll" 或 "No"。
限制:资料未提供具体版本兼容范围、授权、价格或性能数据;部分细节(如引用映射表文件)需查看附带参考资料。V21 路径来自注册表 HKLM\SOFTWARE\Siemens\Automation\InstalledApps\Totally Integrated Automation Portal V21 的 INSTALLPATH 值,二进制位于 PublicAPI\V21\net48。