简介：这份资源为PowerBuilder 9.0相关开发资料包，面向使用该经典快速应用开发工具的开发者、维护旧系统的工程师以及希望了解PB技术栈的学习者，可帮助解决环境搭建、版本查阅与日常开发参考等需求。压缩包为rar格式，整体约1.29MB，体积轻巧便于下载留存；由于上游未提供文件总数与类型明细，包内具体构成以实际解压结果为准。目前已有89人浏览学习，说明该版本在遗留系统维护与教学场景中仍有一定关注度。对于需要接手PowerBuilder 9.0项目、查阅旧版开发资料或补充客户端/数据库应用开发思路的读者，这份资源可作为入门与查阅的起点，建议结合官方文档与实际工程练习使用，以便更快熟悉PB 9.0的开发环境与基本用法。
1. PowerBuilder 9.0 在 2025 年还能干什么：一次遗留系统改造的真实判断
接手一套跑了十几年的业务系统，源码打开一看是 PowerBuilder 9.0 的.pbl工程，这种场景在制造、医疗、政务的存量系统里并不少见。很多人的第一反应是“重写”，但真算过账的工程师都知道，重写一套稳定运行多年的业务系统，风险和成本远高于渐进式改造。PowerBuilder 9.0 是 Sybase 时代的经典 C/S 快速开发工具，核心资产是 DataWindow——一个把 SQL、展示、编辑、打印揉在一起的控件，配合 PowerScript 语言和 PBL 库文件组织代码。它解决的核心问题是：用极少的代码量把数据库表快速变成可增删改查的界面。适合谁？适合手里有存量 PB 系统、需要维护、对接新接口、迁移数据库或做现代化改造的工程师。这篇文章不讲历史，只讲怎么在当下把它跑起来、改得动、接得上。
2. 把 PowerBuilder 9.0 开发环境重新跑起来：安装、连库与第一个可编译工程
2.1 安装顺序与依赖，错一步就白装
PowerBuilder 9.0 对运行环境有明确的顺序要求，装反了会出现“找不到 Sybase 组件”或 IDE 启动即崩。常见做法是按下面的顺序来：
- 先装 PowerBuilder 9.0 主程序（安装包通常分 IDE 和 Runtime 两部分）。
- 再装对应的数据库客户端。PB 9.0 时代主流是 Sybase ASE、SQL Anywhere，也有连 Oracle、SQL Server 的。连什么库就装什么客户端，且位数要和 PB 一致（PB 9.0 基本是 32 位）。
- 最后配置 ODBC 或专用接口（如
O90连 Oracle、SYJ连 SQL Anywhere）。
一个容易翻车的点：PB 9.0 的 IDE 在较新的 Windows 上需要以兼容模式运行。右键快捷方式，兼容性里选 Windows XP SP3，并勾选“以管理员身份运行”。不这么做，打开工程时可能报注册表写入失败。
提示：安装路径不要带中文和空格，PB 9.0 对路径解析比较脆弱，
C:\Program Files\下的空格有时会让某些接口加载失败，建议装到C:\PB9\这类短路径。
2.2 配置数据库连接：从 ODBC 到事务对象
PB 连库的核心是事务对象（Transaction Object），默认叫SQLCA。以 ODBC 连 SQL Anywhere 为例，先在系统里建好 ODBC 数据源，再在应用的Open事件里写连接脚本：
// 应用对象的 Open 事件里配置 SQLCA SQLCA.DBMS = "ODBC" // 使用 ODBC 接口 SQLCA.AutoCommit = False // 关闭自动提交，事务手动控制 SQLCA.DBParm = "ConnectString='DSN=MyDSN;UID=dba;PWD=sql'" // 指向已建好的 ODBC 数据源 CONNECT USING SQLCA; // 执行连接 IF SQLCA.SQLCode <> 0 THEN // SQLCode 非 0 表示失败 MessageBox("连接失败", SQLCA.SQLErrText) HALT CLOSE END IF逻辑说明：DBMS决定用哪种数据库接口，ODBC 最通用但性能一般，专用接口（如O90）更快。AutoCommit = False是业务系统的常规选择，保证一组操作要么全成功要么全回滚。DBParm里的ConnectString是 ODBC 专用写法，换成专用接口时这里要改成SQLCA.ServerName、SQLCA.LogId、SQLCA.LogPass分别赋值。
参数说明：SQLCode是 PB 判断数据库操作结果的关键，0 成功，100 表示无数据，-1 表示错误。SQLErrText是数据库返回的原始错误文本，排错时先看它。
2.3 建第一个可编译工程：PBL、Target 与库搜索路径
PB 9.0 的工程组织是 Target（目标）包含多个 PBL（库文件），PBL 里放窗口、数据窗口、函数、菜单等对象。新建工程的步骤：
- File → New → Target → Application，指定 Target 名和存放路径。
- 向导会让你指定主 PBL 和主应用对象，应用对象是程序入口。
- 建完后在 Target 上右键 → Properties，检查 Library List（库搜索路径）。多个 PBL 时，顺序决定对象查找优先级，公共库放前面。
一个血泪经验：库搜索路径里如果引用了不存在的 PBL，编译不报错，但运行时找不到对象直接崩。每次从别人机器拷工程过来，第一件事就是核对 Library List 里的每个 PBL 是否都在本地存在。
编译发布时，PB 9.0 生成的是.pbd动态库加一个.exe壳。发布机器需要装 PB 9.0 Runtime（一组 DLL），否则 exe 起不来。Runtime 的 DLL 要和编译时的版本严格一致，混用不同小版本的 Runtime 是典型的“开发机能跑、客户机崩”的元凶。
3. DataWindow 才是 PowerBuilder 9.0 的核心资产：SQL、展示与更新怎么拆
3.1 DataWindow 的四种呈现风格与选型
DataWindow 不是普通表格控件，它把数据获取、呈现、编辑、校验、更新打包在一起。PB 9.0 里常用的呈现风格：
| 风格 | 适用场景 | 特点 |
|---|---|---|
| Grid | 列表、明细查询 | 行列对齐，可拖动列宽，最常用 |
| Tabular | 报表式列表 | 列可自由布局，适合打印 |
| Freeform | 单条记录编辑 | 字段自由摆放，适合录入界面 |
| Group | 分组统计 | 按字段分组，带小计 |
选型理由：查询列表用 Grid，录入用 Freeform，打印报表用 Tabular。别用 Grid 做录入，Grid 的编辑体验和字段校验控制不如 Freeform 灵活。
3.2 用 SQL 画 DataWindow 与用存储过程画的差别
DataWindow 的数据源可以是 SQL Select、Stored Procedure、External、Query 等。最常见的是 SQL Select：
-- DataWindow 的 SQL 画板里写的查询 SELECT order_no, customer_id, order_date, amount, status FROM orders WHERE order_date >= :start_date AND order_date <= :end_date AND status <> 'C' ORDER BY order_date DESC逻辑说明：:start_date和:end_date是 PB 的检索参数（Retrieve Argument），在Retrieve()时传入。用参数而不是拼字符串，能避免 SQL 注入，也让 DataWindow 的 SQL 可以被数据库预编译缓存。
参数说明：DataWindow 的更新属性（Update Properties）里要指定“可更新表”“唯一键列”“更新哪些列”。如果 SQL 是多表关联，默认不可更新，需要手动指定更新表，否则Update()返回 -1。
用存储过程做数据源的好处是逻辑集中在数据库端，坏处是调试麻烦、跨库迁移困难。我一般会：查询类用 SQL Select，复杂业务计算用存储过程，但更新操作尽量回到 DataWindow 的更新机制，别在存储过程里做增删改。
3.3 更新机制：Update、Delete、Insert 三件事怎么不打架
DataWindow 的更新靠dw.Update()，它根据行状态（NewModified!、DataModified!、NotModified!）决定发 Insert、Update 还是 Delete。关键配置在 Update Properties：
- Allow Updates：勾选才允许更新。
- Table to Update：指定更新的表。
- Where Clause for Update/Delete：用唯一键列定位，通常选“Key Columns”。
- Updateable Columns：勾选允许更新的列。
// 保存按钮的 Clicked 事件 IF dw_1.ModifiedCount() + dw_1.DeletedCount() = 0 THEN MessageBox("提示", "没有需要保存的修改") RETURN END IF IF dw_1.Update(True, True) = 1 THEN // 第一个 True 接受文本，第二个 True 重置更新标志 COMMIT USING SQLCA; MessageBox("提示", "保存成功") ELSE ROLLBACK USING SQLCA; MessageBox("保存失败", dw_1.GetSQLPreview()) // 打印实际执行的 SQL END IF逻辑说明：Update(True, True)第一个参数表示接受文本编辑（把编辑框里的值写回 DataWindow），第二个参数表示更新成功后重置行状态。失败时用GetSQLPreview()看实际发出的 SQL，这是排查更新问题最直接的手段。
参数说明：ModifiedCount()和DeletedCount()用来判断是否有改动，避免无谓的数据库往返。COMMIT和ROLLBACK必须成对出现，事务边界要清晰。
4. 对接新系统：PowerBuilder 9.0 调 Web API 与数据交换的落地方式
4.1 PB 9.0 没有原生 HTTP 客户端，怎么发请求
PB 9.0 时代没有内置的 REST 客户端，常见做法有三种：调用 Windows 的 WinHTTP/XMLHTTP COM 组件、用 Socket 自己拼 HTTP、或者写一个外部 DLL/命令行工具做中转。最省事的是用 COM：
// 用 WinHTTP COM 组件发 POST 请求 OLEObject loo_http loo_http = CREATE OLEObject IF loo_http.ConnectToNewObject("WinHttp.WinHttpRequest.5.1") <> 0 THEN MessageBox("错误", "无法创建 HTTP 组件") RETURN END IF loo_http.Open("POST", "http://api.example.local/order/sync", False) // False 表示同步 loo_http.SetRequestHeader("Content-Type", "application/json;charset=utf-8") loo_http.Send('{"orderNo":"A001","amount":100}') IF loo_http.Status = 200 THEN ls_response = loo_http.ResponseText // 解析 JSON，PB 9.0 无内置 JSON 解析，需自行处理或调外部组件 ELSE MessageBox("接口失败", String(loo_http.Status)) END IF loo_http.DisconnectObject() DESTROY loo_http逻辑说明：ConnectToNewObject创建 COM 对象，Open的第三个参数False表示同步等待，接口慢时会卡界面，必要时放线程或异步处理。Send发请求体，Status拿 HTTP 状态码，ResponseText拿返回文本。
参数说明：PB 9.0 没有内置 JSON 解析器，返回的 JSON 要么用字符串函数手工截取（脆弱），要么调外部解析组件，要么让接口返回分隔符格式。我一般会：接口层加一个适配服务，把 JSON 转成 PB 好处理的竖线分隔文本，PB 端只做字符串拆分，降低耦合。
4.2 数据交换的三种格式与选择
| 格式 | PB 9.0 处理难度 | 适用场景 |
|---|---|---|
| 竖线/逗号分隔文本 | 低，字符串函数即可 | 批量导入导出 |
| XML | 中，需 DOM/SAX 组件 | 结构化配置、报文 |
| JSON | 高，需外部组件 | 现代 API 对接 |
选型理由：PB 9.0 处理分隔文本最顺手，ImportString、ExportString直接支持。XML 可以用 PB 自带的 XML 服务（部分版本支持）或 MSXML COM。JSON 最麻烦，建议在外部服务里转换。
4.3 用 ImportString/ExportString 做批量数据交换
// 导出 DataWindow 数据为竖线分隔文本 string ls_data ls_data = dw_1.ExportString(ls_data, "|", True, True) // 格式、列标题、行 // 导入文本到 DataWindow long ll_rows ll_rows = dw_2.ImportString(ls_data, "|", 1) // 从第 1 行开始 IF ll_rows < 0 THEN MessageBox("导入失败", "请检查文件格式") END IF逻辑说明：ExportString把 DataWindow 内容导出为字符串，ImportString反向导入。分隔符要和数据内容不冲突，业务数据里如果本身含竖线，要先转义或换分隔符。
参数说明：ExportString的第二个参数是分隔符，第三个是是否带列标题，第四个是是否带行。ImportString的第三个参数是起始行，通常从 1 开始（跳过标题行时用 2）。
5. PowerBuilder 9.0 维护与迁移的避坑清单：五个真实踩坑记录
5.1 坑一：编译通过但运行报“找不到对象”
现象：开发机编译成功，拷到客户机运行，打开某个窗口时报“Object not found”或直接闪退。
原因：库搜索路径（Library List）里引用的 PBL 或 PBD 在客户机上不存在，或者 PBD 版本和 exe 不匹配。
解决：发布前用“库搜索路径核对表”逐个确认 PBD 是否随包发布；exe 和 PBD 必须同一次编译产出，不能混用。客户机上装 Runtime 后，把 PBD 放在 exe 同目录或 Library List 指定的路径。
5.2 坑二：DataWindow 更新返回 -1 但看不出原因
现象：dw.Update()返回 -1，SQLErrText为空或很模糊。
原因：多表关联的 DataWindow 没指定更新表，或者唯一键列选错，导致生成的 UPDATE 语句影响 0 行。
解决：用GetSQLPreview()打印实际 SQL，拿到数据库客户端里手工执行，看是语法问题还是条件不匹配。更新属性里确认“Table to Update”和“Key Columns”正确。
5.3 坑三：中文乱码，导出文件在别的系统打开是问号
现象：PB 里显示正常，导出文本或写文件后，用其他工具打开中文变乱码。
原因：PB 9.0 默认用系统 ANSI 编码，导出文件没带 BOM，或目标系统按 UTF-8 解析。
解决：导出时明确编码，必要时用FileOpen的EncodingUTF8!参数（部分版本支持），或在外部服务里做编码转换。跨系统交换统一用 UTF-8，PB 端做转换。
5.4 坑四：Runtime DLL 版本不一致导致客户机崩溃
现象：开发机运行正常，客户机一启动就报缺 DLL 或崩溃。
原因：客户机装了不同小版本的 PB Runtime，DLL 被覆盖。
解决：发布包自带 Runtime DLL，或明确要求客户机装指定版本的 Runtime。用依赖检查工具核对 exe 依赖的 DLL 版本。
5.5 坑五：OLE 对象没释放，程序越跑越慢
现象：长时间运行后内存持续上涨，最终卡死。
原因：CREATE OLEObject后没有DisconnectObject和DESTROY，COM 对象泄漏。
解决：每个 OLE 对象用完必须成对释放，放在TRY...CATCH...FINALLY或确保所有分支都释放。这是 PB 调外部组件最常见的泄漏点。
6. 让 PowerBuilder 9.0 走得更远：渐进式现代化改造的一个具体技巧
存量 PB 系统最现实的出路不是推倒重来，而是“界面保留、逻辑外移、数据打通”。我一般会用一个具体技巧起步：把 DataWindow 的更新逻辑逐步替换成调用外部服务的“命令模式”，PB 端只负责收集界面数据，业务规则和持久化交给新服务。
具体做法：在 DataWindow 的UpdateStart事件里拦截更新，改为调用外部接口：
// DataWindow 的 UpdateStart 事件，返回 1 表示阻止默认更新 // 改为把变更集发给外部服务 string ls_payload ls_payload = This.ExportString(ls_payload, "|", True, True) OLEObject loo_http loo_http = CREATE OLEObject loo_http.ConnectToNewObject("WinHttp.WinHttpRequest.5.1") loo_http.Open("POST", "http://api.example.local/dw/update", False) loo_http.SetRequestHeader("Content-Type", "text/plain;charset=utf-8") loo_http.Send(ls_payload) IF loo_http.Status = 200 THEN This.ResetUpdate() // 清空更新标志，避免重复提交 RETURN 1 // 阻止 DataWindow 默认更新 ELSE MessageBox("保存失败", loo_http.ResponseText) RETURN 0 // 允许默认更新继续（或直接返回 1 阻止） END IF逻辑说明：UpdateStart返回 1 会阻止 DataWindow 走默认的 SQL 更新路径，改为走外部服务。ResetUpdate()清空行状态，防止下次保存重复提交。这样 PB 端逐渐退化成“界面壳”，业务逻辑集中到新服务，后续替换界面时逻辑不用重写。
参数说明：ExportString的格式要和外部服务约定一致，建议用竖线分隔加列标题，服务端按列名解析。接口失败时返回 0 让默认更新兜底，或返回 1 完全阻止，取决于业务对一致性的要求。
验证方法：改造一个 DataWindow 后，做三组测试——正常保存、并发修改同一记录、接口超时。正常保存看数据是否落库；并发看服务端有没有做乐观锁；超时看 PB 端有没有卡死和回滚。这三组过了，再推广到下一个 DataWindow。
我自己的习惯是：每改造一个模块，先在测试库跑一周，对比新旧两条路径的数据一致性，确认无误再切生产。PB 9.0 这套东西不怕老，怕的是没人敢动。把边界划清楚，一次只动一个 DataWindow，比一次性重写稳得多。希望帮到你。
本文还有配套的精品资源，点击获取
