<vbc>

[This is preliminary documentation and subject to change.]

Compiles Visual Basic.NET programs.

Parameters

Attribute Type Description Required
baseaddress string The preferred base address at which to load a DLL. The default base address for a DLL is set by the .NET Framework common language runtime. False
doc file The name of the XML documentation file to generate. Only supported when targeting .NET 2.0 (or higher). False
imports string Deprecated. Specifies whether the /imports option gets passed to the compiler. False
optioncompare string Specifies whether /optioncompare option gets passed to the compiler. False
optionexplicit bool Specifies whether the /optionexplicit option gets passed to the compiler. The default is false. False
optionoptimize bool Specifies whether the /optimize option gets passed to the compiler. The default is false. False
optionstrict bool Specifies whether the /optionstrict option gets passed to the compiler. The default is false. False
removeintchecks bool Specifies whether the /removeintchecks option gets passed to the compiler. The default is false. False
rootnamespace string Specifies whether the /rootnamespace option gets passed to the compiler. False
output file The output file created by the compiler. True
target string Output type. Possible values are exe, winexe, library or module. True
debug bool Generate debug output. The default is false. False
define string Define conditional compilation symbol(s). False
failonerror bool Determines if task failure stops the build, or is just reported. The default is true. False
if bool If true then the task will be executed; otherwise, skipped. The default is true. False
main string Specifies which type contains the Main method that you want to use as the entry point into the program. False
nowarn string Deprecated. Specifies a comma-separated list of warnings that should be suppressed by the compiler. False
rebuild bool Instructs NAnt to recompile the output file regardless of the file timestamps. False
timeout int The maximum amount of time the application is allowed to execute, expressed in milliseconds. Defaults to no time-out. False
unless bool Opposite of if. If false then the task will be executed; otherwise, skipped. The default is false. False
verbose bool Determines whether the task should report detailed build log messages. The default is false. False
warnaserror bool Instructs the compiler to treat all warnings as errors. The default is false. False
win32icon file Icon to associate with the application. False

Framework-configurable parameters

Attribute Type Description Required
exename string The name of the executable that should be used to launch the external program. False
supportsnowarnlist bool Indicates whether the compiler for a given target framework supports a command line option that allows a list of warnings to be suppressed. The default is false. False
supportspackagereferences bool Indicates whether package references are supported by compiler for a given target framework. The default is false. False
supportswarnaserrorlist bool Indicates whether the compiler for a given target framework supports the "warnaserror" option that takes a list of warnings. The default is false. False
useruntimeengine bool Specifies whether the external program should be executed using a runtime engine, if configured. The default is false. False

Nested Elements:

<imports>

<import ... />

The namespaces to import.

Contains a collection of NamespaceImport elements.

<import ... />
...

</imports>

<warnaserror>

Controls which warnings should be reported as errors.

</warnaserror>

<nowarn>

<warning ... />

Specifies a list of warnings that you want the compiler to suppress.

Contains a collection of CompilerWarning elements.

<warning ... />
...

</nowarn>

<lib>

Deprecated. Additional directories to search in for assembly references.

</lib>

<references>

Reference metadata from the specified assembly files.

</references>

<pkg-references>

Specifies list of packages to reference.

Contains a strongly typed collection of Package objects.

</pkg-references>

<resources>

Resources to embed.

Contains a strongly typed collection of <resourcefileset> objects.

</resources>

<modules>

Link the specified modules into this assembly.

</modules>

<sources>

The set of source files for compilation.

</sources>

<arg>

The command-line arguments for the external program.

Contains a collection of Argument elements.

</arg>

Examples

Requirements

Assembly: NAnt.DotNetTasks (0.85.1793.0)