Help
Task Reference
<regasm>|
NAntContrib
Help
Task Reference
<regasm> |
v0.85-rc1 |
[This is preliminary documentation and subject to change.]
Registers an assembly for use from COM clients.
Refer to the Regasm documentation for more information on the regasm tool.
| Attribute | Type | Description | Required |
|---|---|---|---|
| assembly | file | The name of the file to register. This is provided as an alternate to using the task's fileset. | False |
| codebase | bool | Set the code base registry setting. | False |
| exporttypelib | bool | Export a typelib and register it. The typelib will have the same name as the source assembly unless the typelib attribute is used. |
False |
| regfile | file | Registry file to export to instead of entering the types directly into the registry. If a fileset is used then the entries are all collated into this file. | False |
| registered | bool | Only refer to already registered type libraries. | False |
| typelib | file | Export the assembly to the specified type library and register it. This attribute is ignored when a fileset is specified. | False |
| unregister | bool | Unregister the assembly. The default is false. | 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 |
| 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 |
| Attribute | Type | Description | Required |
|---|---|---|---|
| exename | string | The name of the executable that should be used to launch the external program. | False |
| useruntimeengine | bool | Specifies whether the external program should be executed using a runtime engine, if configured. The default is false. | False |
Contains a collection of Argument elements.
Register a single assembly.
<regasm assembly="myAssembly.dll" />
Register an assembly while exporting a typelibrary.
<regasm assembly="myAssembly.dll" typelib="myAssembly.tlb" />
Register a set of assemblies at once.
<regasm unregister="false" codebase="true">
<fileset>
<include name="**/*.dll" />
<exclude name="notanassembly.dll" />
</fileset>
</regasm>