This documentation is archived and is not being maintained.

Build Page, Project Designer (J#)

Visual Studio 2005

This topic has been updated for Visual Studio 2005 SP1.

Use the Build page of the Project Designer to specify the project's build configuration properties. This page applies to Visual J# projects only.


If the Show advanced build configurations option is not selected in the General, Projects and Solutions, Options Dialog Box, then Configuration and Platform will not appear in the Project Designer. By default, Show advanced build configurations is selected.

How to: Set Build Properties (C#, J#)


Specifies which configuration settings to display or modify. The settings can be Active (Debug) (this is the default), Debug, Release, or All Configurations.

The settings you select on the Build page apply only to the configuration that you select here. The configuration selection sets default values for Conditional Compilation Symbols, Optimize Code, and Output Path.

You can also define custom build configurations. See Build Configurations for more information.


Specifies which platform settings to display or modify. The default setting is Active (Any CPU). You can change the active platform using the Configuration Manager. For more information, see How to: Create and Edit Configurations.

Conditional Compilation Symbols

Specifies symbols on which to perform conditional compilation.

By default, DEBUG and TRACE are defined for the Debug configuration.

Separate symbols with a semi-colon or comma. For more information, see /define (Preprocessor Definition) (Visual J#).

For more information about how to programmatically access this property, see DefineConstants.

Optimize Code

Enable or disable optimizations performed by the compiler to make your output file smaller, faster, and more efficient.

By default, this option is set for the Release configuration. Cancel the selection when you do not need optimizations, for example, when you are debugging.

Warning Level

Specifies the level to display for compiler warnings. See /warn (Specify Warning Level) (Visual J#) for more information.

Suppress Warnings

Keeps the compiler from generating the specified warning levels. Separate multiple warning level numbers with a comma. See /nowarn (Suppress Specified Warnings) (Visual J#) for more information.

Treat Warnings As Errors

Select one of the following options to indicate under what conditions to return an error when the build encounters a warning.

See /warnaserror (Treat Warnings as Errors) (Visual J#) for more information.


The default. Do not treat warnings as errors.


Treat all warnings as errors. Messages ordinarily reported as warnings are reported as errors, and the build process is stopped (no output files are built).

Output Path

Specifies the location of the output files for this project's configuration. Note that the path is relative; even if you enter an absolute path, it will be saved as relative.


With simplified build configurations, the project system determines whether to build a debug or a release build. Clicking Build on the Debug menu will place the build in the debug location regardless of the Output path you specified. Clicking Build on the Build menu puts the build in the location you specified. To enable manual control over all configuration values, including whether debug or retail is built, disable simplified build configurations. To do this, click Options on the Tools menu. In the Options dialog box, navigate to Projects and Solutions, and then General. Clear the Show advanced build configurations check box.

XML Documentation File

Specifies the name of a file into which documentation comments will be processed.

Register for COM Interop

Indicates that the managed application exposes a COM object (a COM-callable wrapper), enabling a COM object to interact with the managed application. The Output Type property of this application must be Class Library to make the Register for COM Interop property available. For more information, see Application Page, Project Designer (Visual Basic).

In order for the COM object to be exposed, your class library assembly must also have a strong name. See the AssemblyInfo.jsl file in Solution Explorer for a way to specify a strong name for your assembly.


Click to display the Advanced Build Settings Dialog Box (J#) dialog box.

See Also