Incremental Rebuild for .NET
\The Sandbox \PB History & Future \New in PB 11 \New in PB 11.1 \Incremental Rebuild
Vista support
Pipelines in
Windows Forms
Web Services
from Web Forms
RTL DatePicker
& MonthCalendar
RTE Page
Display Properties
Null Values as
Retrieval Args
Informix 10 Support
Oracle 10g
Stmt Caching
Identity Columns

PowerBuilder 11.1 introduces incremental builds for .NET application targets, allowing you to save time while deploying applications for testing or production purposes. This feature means that only the classes that are affected by one or more changes are recompiled during the build process.

Target level

The incremental rebuild process for .NET targets is conducted as the first step of a project's deployment to a .NET platform. Although deployment remains at the project level, incremental rebuilds are done at the target level. This means multiple projects within a single target can benefit by sharing the same incremental build assemblies or .NET modules.

.NET Web Service and .NET Assembly targets  Incremental builds are not available for .NET component targets. The PowerBuilder .NET compiler always does full rebuilds for these target types.

For detailed information on build directories and .NET modules created for incremental builds, see the chapter on "Compiling and Debugging" in the Deploying Applications and Components to .NET book, available in the compiled HTML Help.

Triggering build and deploy operations

PowerBuilder lets you trigger build and deploy operations when you run or debug a .NET Web Forms or Windows Forms project. By default, when you click the running man or debugging icon in the PowerBuilder toolbar, or select Run from a project menu or context menu for one of these target types, PowerBuilder determines if there is a corresponding build directory for the selected target. If there is, PowerBuilder checks whether the .NET modules in the build directory are consistent with the latest changes to each object in your current application.

If implementation or interface changes are detected or if the build directory does not exist for the current target, PowerBuilder displays a message box that tells you the project is out of date and that prompts you to redeploy the project. The message box has three buttons (Yes, No, and Cancel) and a check box that lets you prevent the display of the message box the next time you click or select run (or debug).
If you click Yes in the message box, PowerBuilder builds the project using an incremental or full rebuild—depending on the current rebuild scope—and then redeploys it, using the current project's deployment specifications. If you click No in the message box with the redeployment prompt, PowerBuilder attempts to run or debug the currently deployed target even though it is out of date. Clicking Cancel terminates the run or debug request.

If you select this "Do not ask me again" check box and then click the Yes or No button, PowerBuilder modifies a drop-down list selection on the General tab of the System Options dialog box.

System option

The "On click Run, if .NET application projects are out of date" drop-down list selection on the General tab of the System Options dialog box determines whether a message box displays when you run or debug a project and project objects have been modified. The following table shows the choices available in this drop-down list:


Effect when you click or select Run (or debug)

Ask me

(Default selection.) Causes a message box to display if the current project has been modified since the last time it was deployed or if it has never been deployed before.

Always redeploy

Always redeploys a project before running or debugging it. It first rebuilds the project using the rebuild scope set in the Project painter.

Never redeploy

Never redeploys a project before trying to run it, although it does deploy a project that has not been previously deployed, and then attempts to run or debug that project. (You should not use this option if you want to debug a project that you have previously deployed.)

The message box that prompts you to redeploy an out-of-date project can display only when the drop-down list selection is "Ask me." This selection changes automatically to "Always redeploy" if you click Yes in the message box when the "Do not ask me again" check box is selected. It changes to "Never redeploy" if you click No in the message box when the "Do not ask me again" check box is selected.

PBL Peeper PB Help PB History
& Future About Us Feedback Site Map