NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

/incremental (Enable Incremental Compilation)

/incremental[+ | -]

Remarks

The /incremental compiler option enables the incremental compiler, which compiles only those functions that changed since the last compilation. Information about the state of the previous compilation is stored in the following files, which are created by the compiler:

output_file_name.dbg
When compiling with /debug, the status of debug information is stored in the .pdb file.
output_file_name.extension.incr
Information about the status of the compilation, other than debug information, is stored in a .incr file.

The first time you use /incremental, the .incr and .pdb filesare updated and all subsequent compilations will be incremental. Changing the compiler options from the previous /incremental compilation will cause a full rebuild of the .incr and .pdb files.

If the compiler cannot find the project's .pdb or .incr files, a full rebuild will occur.

By default, /incremental- is in effect. Specifying /incremental is the same as specifying /incremental+.

Output files created with the /incremental option may be larger than those created with incremental compilation disabled. Because the output files can be larger, you should use /incremental- in the final build of your output file.

/incremental will speed compilation on projects with many, smaller files, and will have little or no speed improvement on projects with fewer, large files.

Example

Compile in.cs using the incremental compiler:

csc /incremental in.cs

See Also

C# Compiler Options