next up previous contents index
Next: <WsdlToDotnet> Up: NET Tasks Previous: <CSC>   Contents   Index

<ilasm>

Task to assemble .net 'Intermediate Language' files. The task will only work on windows until other platforms support csc.exe or an equivalent. ilasm.exe must be on the execute path too.

All parameters are optional: <il/> should suffice to produce a debug build of all *.il files. The option set is roughly compatible with the CSharp class; even though the command line options are only vaguely equivalent. [The low level commands take things like /OUT=file, csc wants /out:file ... /verbose is used some places; /quiet here in ildasm... etc.] It would be nice if someone made all the command line tools consistent (and not as brittle as the java cmdline tools)

The task is a directory based task, so attributes like includes="*.il" and excludes="broken.il" can be used to control the files pulled in. Each file is built on its own, producing an appropriately named output file unless manually specified with outfile

Attribute Description Example
defaultexcludes indicates whether default excludes should be used or not ("yes"/"no"). Default excludes are used when omitted.  
debug include debug information true (default)
excludes comma separated list of patterns of files that must be excluded. No files (except default excludes) are excluded when omitted.  
excludesfile the name of a file. Each line of this file is taken to be an exclude pattern  
extraOptions Any extra options which aren't explicitly supported by the ilasm task, primarily because they arent really documented: use ilasm /? to see them  
failOnError Should a failed compile halt the build? "true"(default)
fullpaths Should error text provide the full path to files "true"(default)
includes comma separated list of patterns of files that must be included. All files are included when omitted.  
includesfile the name of a file. Each line of this file is taken to be an include pattern  
keyfile the name of a file containing a private key, with which the assembly output is checksumed and then MD5 signed to have a strong name  
listing Produce a listing (off by default). Listings go to the current output stream "on", "off" (default)
outputFile filename of output "example.exe"
resourceFile name of resource file to include "resources.res"
srcDir source directory (default = project directory)  
targetType Type of target. library means DLL is output. "exe"(default), "library"
verbose output progress messages "on", "off" (default)

Example

<ilasm
        outputFile="app.exe"
        verbose="on"
        listing="on"
        owner="secret"
        />

next up previous contents index
Next: <WsdlToDotnet> Up: NET Tasks Previous: <CSC>   Contents   Index
Andrew Marlow 2003-07-08