Summary

Installs assemblies into the Global Assembly Cache (GAC) by using the gacutil SDK tool.

Assembly

NAnt.Contrib.dll

Namespace

NAnt.Contrib.Tasks

Base Types

ExternalProgramBase
GacTaskBase

graph BT Type-->Base0["GacTaskBase"] click Base0 "/api/NAnt.Contrib.Tasks/GacTaskBase" Base0-->Base1["ExternalProgramBase"] Type["GacInstallTask"] class Type type-node

Syntax

[ProgramLocation(LocationType.FrameworkSdkDir)]
[TaskName("gac-install")]
public sealed class GacInstallTask : GacTaskBase

Examples

Installs Shared.dll into the GAC.

    <gac-install>
    <assemblies>
        <include name="Shared.dll" />
    </assemblies>
</gac-install>

Installs Shared.dll and MyWeb.dll into the GAC.

    <gac-install>
    <assemblies>
        <include name="Shared.dll" />
        <include name="MyWeb.dll" />
    </assemblies>
</gac-install>

Installs Shared.dll and MyWeb.dll into the GAC and specifies reference information.

    <gac-install>
    <reference scheme-type="Opaque" scheme-id="MyID" scheme-description="My description" />
    <assemblies>
        <include name="Shared.dll" />
        <include name="MyWeb.dll" />
    </assemblies>
</gacinstall>

Remarks

Assemblies can be installed to the GAC with or without reference counting. The full details of reference counting can be found in the SDK documentation.

Attributes

Type	Description
ProgramLocation
TaskName

Constructors

Name	Summary
GacInstallTask()	Constructs and initialises an instance of the `GacInstallTask`.

Properties

Name	Value	Summary
Assemblies	AssemblyFileSet	Specifies the assemblies to install.
AssemblyList	ICollection	Gets the assembly list to install.
CurrentAssembly	string	Gets the current assembly being operated against. Inherited from GacTaskBase
ExeName	string	Gets the executable name for the `gacutil` command-line tool. Inherited from GacTaskBase
Force	bool	If `true`, the specified assemblies will be forcibly installed. Any existing duplicate assemblies in the GAC will be overwritten. The default is `false`.
Managed	ManagedExecution	Gets a value indiciating whether the external program is a managed application which should be executed using a runtime engine, if configured. Inherited from GacTaskBase
ProgramArguments	string	Gets the program arguments with which to run the `gacutil` process. Inherited from GacTaskBase
Reference	GacReference	Specifies reference details to use when working with the GAC. Inherited from GacTaskBase
ReferenceSpecified	bool	Specifies whether a reference was specified for the GAC task. Inherited from GacTaskBase

Methods

Name	Value	Summary
AppendProgramArguments(StringBuilder)	void	Appends any install-specific arguments.
BeforeExecuteTask()	void	Outputs log information.
ExecuteTask()	void	Executes the task. Inherited from GacTaskBase
Initialize()	void	Validates the task's configuration. Inherited from GacTaskBase
StartProcess()	Process	Starts the process that is wrapped by this GAC task. Inherited from GacTaskBase

GacInstallTask Class