本节展示了如何在C#中创建一个EPLAN插件。为了说明安装.NET Framework已经提供了所有必要的工具(如C#编译器等),该插件并不是作为一个Visual Studio项目创建的,而是简单地使用文本编辑器和.NET Framework的命令行工具。
首先,创建一个目录来存储你的插件源代码是很有用的。在这个例子中,我们创建一个名为“SimpleCSharpAddIn”的文件夹。 现在启动你喜欢的文本编辑器,例如记事本,并开始编写源代码。
每个EPLAN插件,包括我们将要创建的C#插件,都需要一个特定的类来管理该插件。这个类必须实现IEplAddIn接口声明的函数:
public class AddInModule: Eplan.EplApi.ApplicationFramework.IEplAddIn
{
public bool OnRegister(ref System.Boolean bLoadOnStart)
{
bLoadOnStart=true;
return true;
}
public bool OnUnregister()
{
return true;
}
public bool OnInit()
{
return true;
}
public bool OnInitGui()
{
return true;
}
public bool OnExit()
{
return true;
}
}
现在将这个源代码保存到文件夹 "SimpleCSharpAddIn
" 中,文件名为 "AddInModule.cs
"。
现在是时候使用C#编译器了。编译器位于 .NET Framework 的目录中,例如 C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727。这个文件夹应该在搜索路径中。打开你喜欢的命令行工具并切换到你刚刚保存 "AddInModule.cs" 的 "SimpleCSharpAddIn" 目录。
使用以下参数运行C#编译器(csc.exe):
txt
csc /target:library /reference:..\\..\\..\\..\\bin\\Eplan.EplApi.AFu.dll /out: EPLAN.EplAddin.SimpleCSharp.dll AddinModule.cs
这些参数的含义是什么?
/target:library
:我们想要创建一个DLL文件,而不是一个可执行文件(exe)。/reference:........\\bin\\Eplan.EplApi.AFu.dll
:在 Eplan.EplApi.AFu.dll 中搜索所有缺失的数据(例如 IEplAddIn)。/out: EPLAN.EplAddin.SimpleCSharp.dll
:要生成的DLL的名称是 "EPLAN.EplAddin.SimpleCSharp.dll"。AddinModule.cs
:要编译的源文件的名称。如果编译过程中没有出错,现在你会在 "SimpleCSharpAddIn" 文件夹中找到DLL "EPLAN.EplAddin.SimpleCSharp.dll"。将此文件复制到EPLAN平台的 bin 文件夹中。
d) 在EPLAN中加载一个插件
现在启动EPLAN。如果以下系统扩展在EPLAN中加载(通常应该是这样):EplanEplApiModuleu.erx, EplanEplApiModuleGUIu.erx。