（本文为酷鱼[QQ:563965672]原创作品）

本文描述如何能运行“Example 3 (Visual C# 2005)”样例代码。环境为SAP2000 V12.0.2 + Visual Studio 2008.

1. 打开VS2008，新建项目，选C#, Windows窗体应用程序，名称为Example3，如下图所示。

http://s1/bmiddle/539bb0a7t6612c1caea50API入门指南（一）从外部程序调用" TITLE="[转载]SAP2000 API入门指南（一）从外部程序调用" />

2. 添加对SAP2000 API的引用。选菜单“项目/添加引用”，如下图：

http://s14/bmiddle/539bb0a7t6612d27512ddAPI入门指南（一）从外部程序调用" TITLE="[转载]SAP2000 API入门指南（一）从外部程序调用" />

在弹出的“添加引用”对话框中，选“浏览”标签，选中SAP2000目录下的SAP2000.exe文件，如下图。

http://s13/bmiddle/539bb0a7t6612e07bf5dcAPI入门指南（一）从外部程序调用" TITLE="[转载]SAP2000 API入门指南（一）从外部程序调用" />

按“确定”按钮。VS2008生成了对SAP2000 API的引用。

在项目的“引用”中新增了“CsiGoCallbackLib”和“Sap2000”两项。可以展开“Sap2000”引用项看看，里面提供了许多类和方法，如下图.

http://s3/bmiddle/539bb0a7t66133c487102API入门指南（一）从外部程序调用" TITLE="[转载]SAP2000 API入门指南（一）从外部程序调用" />

3. 添加按钮。在解决方案中双击"form1.cs"，在对话框中放置一个按钮，将该按钮的name改为"buttonTest", 将其Text改为“测试”，如下图。

http://s16/bmiddle/539bb0a7t66134ef97f2fAPI入门指南（一）从外部程序调用" TITLE="[转载]SAP2000 API入门指南（一）从外部程序调用" />

4. 为按钮添加代码。双击“测试”按钮，切换到代码视图，在函数buttonTest_Click中添加代码。我们将API文档的"Example 3 (Visual C# 2005)"中的代码粘贴到这里。存盘、编译。VS2008会报17个错误，都是“找不到类型或命名空间名称“SAP2000””。原因是引用了SAP2000 API后，VS2008自动给出的命名空间是“Sap2000”，而样例代码中的是"SAP2000"，大小写不同。

5. 修改错误。将“SAP2000”全部替换为“Sap2000”。再编译，还有错误，包括以下地方：

            ret = SapModel.View.RefreshView(0, ref temp_bool);

函数原型为：

        int RefreshView(int Window, bool Zoom);
第2个参数前不应有ref，删除之，变为：

            ret = SapModel.View.RefreshView(0, temp_bool);

错误：
            ret = SapModel.LoadPatterns.Add("1", Sap2000.eLoadPatternType.LTYPE_OTHER, 1, ref temp_bool);
函数原型为：

        int Add(string Name, eLoadPatternType MyType, double SelfWTMultiplier, bool AddAnalysisCase);
第4个参数前不应有ref，删除之，变为：

            ret = SapModel.LoadPatterns.Add("1", Sap2000.eLoadPatternType.LTYPE_OTHER, 1, temp_bool);

将所有错误处按以上方法修改后，编译通过。

 6. 建立文件夹C:SapAPI，程序会将SAP文件存放在这里。运行程序，按“测试”按钮。程序自动启动SAP2000，自动建模，自动分析，自动关闭SAP2000，并用一个对话框输出结果，如下图所示：

http://s14/bmiddle/539bb0a7t709b99dace8dAPI入门指南（一）从外部程序调用" TITLE="[转载]SAP2000 API入门指南（一）从外部程序调用" />

我们现在去看看程序自动建立的模型。用SAP2000打开C:SapAPIAPI_1-001.sdb，可以看到已建立好的模型，如下图：

http://s8/bmiddle/539bb0a7t664c8f714e57API入门指南（一）从外部程序调用" TITLE="[转载]SAP2000 API入门指南（一）从外部程序调用" />

博客里放不了附件，需要源码的朋友请与我联系，QQ:563965672