SIEMENS西门子 混合连接器电缆 6FX3802-7DN01-1AF0

          创建 C# 程序 对 Add-In进行编程时，需要一个项目创建类库。还需在该项目中添加“Siemens.Engineering.AddIn.dll”文件的引用。从而建立与 Openness API 的连接。 创建项目要创建一个新的 C# 项目编写 Add-In 程序，请按以下步骤操作： 1. 通过“文件 -> 新建 > 项目”(File-> New > Project) 打开“新建项目”(New project) 对话框。 2. 在“已安装 >Visual Studio”(Installed > Visual Studio) 下，选择条目“类库 (.NETFramework)”(Class library (.NET Framework))。3. 指定项目的名称和存储位置。 4.单击“确定”(OK)，确认输入。 Visual Studio 则使用新项目创建项目文件夹。用户可随时在该项目文件夹中添加更多项目（类库），这样，即可编程各种 Add-In 包。 添加引用要插入对文件“Siemens.Engineering.AddIn.dll”的引用，请执行如下步骤： 1.右键单击项目文件夹中的“引用”(References) 条目，在快捷菜单中选择“添加引用”(Add reference) 条目。引用管理器随即打开。 2. 单击左侧“浏览”(Browse) 上的概述，在“浏览”(Browse) 按钮下方单击。 3. 在TIA Portal 安装目录的“PublicAPI\[Versionsnummer].AddIn”下浏览到文件“Siemens.Engineering.AddIn.dll”，单击“添加”(Add)。 4. 单击“确定”(OK)关闭引用管理器。 5. 选择新引用“Siemens.Engineering.AddIn”并打开属性。 6.将属性“本地副本”(Local copy) 设置为“True”。 必要时，可采用相同方式添加其它引用： • 如需使用用户自定义Add-In 启动其它进程，则可添加“Siemens.Engineering.AddIn.Utilities.dll”文件的引用。该文件位于“Siemens.Engineering.AddIn.dll”文件所在目录中。 • 如需使用用户自定义 Add-In 与其它 TIAPortal 实例建立连接，则需添加文件“Siemens.Engineering.dll”的引用。此文件位于目录“PublicAPI\[版本号]”中。 结果该项目已创建，可以开始编程 Add-In。必要时，可在项目中插入更多引用。 • 证书有关信息 • 多用户会话中 Add-In的显示 完成 Add-In 程序的编写后，所生成的 dll 文件需转换为扩展名为“addin”的文件。为此，可使用系统程序“Siemens.Engineering.AddIn.Publisher.exe”和用户自定义的组态文件。将addin 文件复制到 TIA Portal 的安装目录中。此后，该 Add-In 即可在 TIA Portal 中激活并使用。 说明请注意以下事项： • 请注意，由于该 Add-In 会在执行后取消加载，所执行的实例将无法继续使用。即，系统将取消那些在后台线程中运行时间较长的任务，再启动一个新进程执行这些运行时间较 长的任务。 • 不建议通过 TIA PortalAdd-In 关闭项目。 权限 在组态文件中，可在“RequiredPermissions”元素中组态 Add-In 的以下权限： •TIAPermissions：TIA Portal 的读写权限 • SecurityPermissions：安全相关权限，如启动进程• UnrestrictedPermissions：对 TIA Portal 的无限制访问“SecurityPermissions”和“UnrestrictedPermissions”不能一起使用。此时，可使用“SecurityPermissions”指定特定的权限，也可使用“UnrestrictedPermissions”指定无限制访问权限。例如，访问 Microsoft Interop API 或使用特定引用时，需具有无限制访问权限。但请注意，具有不受限制访问权限的 Add-Ins 将具有已登录用户的所有权限。将具有更多权限，从而可能存在潜在风险，甚至执行恶意代码。在组态文件中，需指定进行 无限制访问的原因。该原因将显示在 TIAPortal 内“Add-Ins”任务卡“详细信息”(Details) 选项 板中。TIA Portal Add-InDevelopment Tools 可以参考以下描述的内容手动创建 C# 项目以及必要的类和方法，也可以使用 TIA PortalAddIn Development Tools。使用 TIA Portal Add-In Development Tools可以更轻松地完成以下任 务： • 创建 C# 项目 可以使用项目模板来创建 Add-In 的 C#项目。通过此方式，项目中将直接包含重要的类 和方法。 • 创建程序代码 可以使用模板来创建所需 Add-In类型的程序框架。对所需的功能进行编程。 • 编译和调试 使用 TIA Portal Add-In DevelopmentTools 可以轻松编译和调试程序代码。 在 Microsoft Visual Studio 2019 或 2022 或 VisualStudio Code 中使用 TIA Portal Add-In Development Tools。 有关 TIA PortalAdd-In Development Tools 以及所需安装文件的更多信息，请参见 TIA Portal 安装包的 DVD2。

            编程视图提供程序在视图提供程序中，可定义 TIA Portal 中显示 Add-In 快捷菜单的区域。为每个提供程序类型创建一个单独的类，并为相应的视图创建代码。可编程以下视图提供程序： • “ProjectTreeAddInProvider”：在项目树中显示快捷菜单。 • “GlobalLibraryTreeAddInProvider”： 在全局库中显示快捷菜单。 •“ProjectLibraryTreeAddInProvider”： 在项目库中显示快捷菜单。 •“DevicesAndNetworksAddInProvider”：在硬件与网络编辑器中显示快捷菜单。但需注意，硬件与网络编辑器的以下区域不能显 示快捷菜单： – 网络视图中的“I/O 通信”(I/Ocommunication) – 网络视图中的“连接”(Connections) 表 • “VciAddInProvider”： 在Version Control Interface 工作区显示快捷菜单。创建 Add-In 的程序代码 使用 C# 和 TIAPortal Openness API 为 Add-In 创建程序代码时，需确保所有必要的引用和使 用指令有效可用。用户自定义Add-In 基本上可使用 TIA Portal Openness API 的所有功能。但 需要注意以下两个功能的一些特性： • 使用Add-In 启动其它进程： 除了创建连接的程序代码之外，还必须允许在组态文件中启动新进程。 • 创建与其它 TIA Portal实例的连接： 需要对程序集“Siemens.Engineering.AddIn.dll”进行下述引用以创建 Add-Ins。要启动其它TIA Portal 实例，需要额外引用“Siemens.Engineering.dll”程序集。但这两个程序集包含一些相同的完全限定类型名称。可使用外部程序集别名来通知编译器要使用的类型所来自的程序集。此过程与命名空间类似。如果不使用别名，用户将收到编译错误。Add-In 创建概述 过程 为确保 TIA Portal识别并显示 Add-In，需将 dll 文件转换为扩展名为“addin”的文件。为此，可使用命令行程序“Siemens.Engineering.AddIn.Publisher.exe”，该程序位于 TIA Portal安装目 录的“PublicAPI”文件夹中。可在创建 dll 文件后单独执行该程序，也可以直接在编程环境（例 如 MicrosoftVisual Studio）中将其作为编译后事件执行。 用户可根据需求使用 XML 文件自定义执行方式。例如，可使用证书确保Add-Ins 安全并指 定授权。需要为每个 Add-In 包生成一个 XML 文件。为该 XML 文件提供一种架构；该 XML 文件必须对这一架构有效。可根据需要为 XML 文件命名，例如“Configuration.xml”。通过 DLL 创建 Add-In通过 dll 文件创建 addin文件时，需使用“Siemens.Engineering.AddIn.Publisher.exe”程序， 该程序位于 TIAPortal 安装目录的“PublicAPI”文件夹中。还需一个 XML 格式的有效组 态文件。可通过以下几种方式，将 dll文件转换为 addin 文件： • 可使用 Windows 命令提示符 (CMD) 和相应参数执行“Siemens.Engineering.AddIn.Publisher.exe”程序。 •可将“Siemens.Engineering.AddIn.Publisher.exe”程序作为编译后事件添加到 VisualStudio 中，并且始终可在创建 dll 文件时执行此程序。 下表列出了程序执行期间可使用的参数：Add-In API 的基本知识消息 API 简介 通过 Add-In API，可以在 Add-Ins 中编写运行期间显示的消息。这些消息的显示方式与其它 TIAPortal 消息相同。可将 Add-In 无缝集成到 TIA Portal 中。 不同消息类型对应不同的API。不需要执行其它安装步骤，便可将这些 API 集成到程序代码中。 支持以下 API： • 反馈功能借助反馈功能，可在巡视窗口和日志中显示消息。 另请参见：反馈 API (页 179) • 进度功能 可通过进度 API显示进度消息。 另请参见：进度 API (页 181) • Messagebox 功能 可通过 Messagebox API显示任何对话框窗口和确认对话框。 另请参见：Messagebox API (页 184)反馈 API 简介 可以使用 TIAPortal 的反馈服务向 Add-In 用户发送消息。可以在发生错误时或其它情况下提 供详细信息。这些消息的显示位置取决于Add-In 的类型： • 巡视窗口中的默认选项卡 所有 Add-Ins 均可在巡视窗口的“信息 > 常规”(Info >General) 选项卡中显示消息。 • 巡视窗口中的特定选项卡或日志如果工作流程在巡视窗口的特定选项卡中显示相关消息，或将消息记录在日志中，则此 类工作流程的 Add-In也可在这些位置显示其消息。如果工作流程未使用特定位置，则仍 可在巡视窗口的“常规 > 信息”(General >Info) 选项卡中显示消息。进度 API 简介 如果 Add-Ins执行时间较长，可以显示操作进度。为此，可在对话框窗口中显示进度消息。 通过“取消”(Cancel) 按钮可以关闭该对话框窗口。在Add-In 中编写此情况的执行代码。 只有工作流程 Add-Ins 可以显示进度消息。 说明 有限进度消息 请注意，Add-InProgress API 不能对工作流的有限进度消息文本进行扩展，但可对无限进度消息的文本进行扩展。有限进度消息是指以百分比值形式显示的进度的进度消息。可通过“TiaPortal”对象访问“GetProgressContext”方法。• workflowcontext：该参数包含与当前执行的工作流程相关的信息。 该值是由工作流程 Add-In API生成的，只能读取使用。 此方法返回“ProgressContext”。该值用于将 Add-In 的进度消息添加到工作流程现有的进度消息中。如果工作流程尚未显示任何进度消息，仍 可提供有关已传送上下文的进度消息。在这种情况下，显示新的 Add-In进度消息。