C# Source Code: Programmatically adding and removing assemblies from the GAC (without using GACUTIL)
[
Home
|
Contents
|
Search
|
Reply
| Previous |
Next
]
C# Source Code
Programmatically adding and removing assemblies from the GAC (without using GACUTIL)
By:
Andrew Baker
Email (spam proof):
Email the originator of this post
Date:
Thursday, November 03, 2005
Hits:
4891
Category:
General/Framework
Article:
The C# code below demonstrates how to programmatically add and remove items from the Global Aseembly Cache (GAC). using System; using System.IO; using System.Runtime.InteropServices; #region AssemblyCommitFlags Enum /// <summary> /// Enum which descibes how to add the assembly to the GAC. /// </summary> public enum AssemblyCommitFlags { /// <summary> /// Default installation. /// </summary> Default = 1, /// <summary> /// Forces reinstall of an assembly regardless of any existing assembly with the same assembly name. /// </summary> Force = 2 } #endregion AssemblyCommitFlags Enum #region AssemblyCacheUninstall Enum /// <summary> /// Enum to return the status of an GAC uninstall request. /// </summary> public enum AssemblyCacheUninstall: int { /// <summary> /// Unknow error. /// </summary> Unknown = 0, /// <summary> /// The assembly files have been removed from the GAC. /// </summary> Uninstalled = 1, /// <summary> /// An application is using the assembly. /// This value is returned on Microsoft Windows 95 and Microsoft Windows 98. /// </summary> StillInUse = 2, /// <summary> /// The assembly does not exist in the GAC. /// </summary> AlreadyUninstalled = 3, /// <summary> /// Not used. /// </summary> DeletePending = 4, /// <summary> /// The assembly has not been removed from the GAC because another application reference exists. /// </summary> HasInstallReference = 5, /// <summary> /// The reference that is specified in pRefData is not found in the GAC. The return values are defined as follows: /// S_OK - The assembly has been uninstalled. /// S_FALSE - The operation succeeded, but the assembly was not removed from the GAC. The reason is described in pulDisposition. /// </summary> ReferenceNotFound = 6 } #endregion AssemblyCacheUninstall Enum #region IAssemblyCache Interface /// <summary> /// Represents the Global Assembly Cache for use by Fusion. /// </summary> [ComImport, InterfaceType(ComInterfaceType.InterfaceIsIUnknown), Guid("e707dcde-d1cd-11d2-bab9-00c04f8eceae")] internal interface IAssemblyCache { /// <summary> /// Uninstalls the specified assembly from the Global Assembly Cache. /// </summary> [PreserveSig()] int UninstallAssembly(uint dwFlags, [MarshalAs(UnmanagedType.LPWStr)] string pszAssemblyName, IntPtr pvReserved, out AssemblyCacheUninstall pulDisposition); /// <summary> /// Gets the requested data about the specified assembly. /// </summary> [PreserveSig()] int QueryAssemblyInfo(uint dwFlags, [MarshalAs(UnmanagedType.LPWStr)] string pszAssemblyName, IntPtr pAsmInfo); /// <summary> /// Gets a new IAssemblyCacheItem /// </summary> [PreserveSig()] int CreateAssemblyCacheItem(uint dwFlags, IntPtr pvReserved, out /*IAssemblyCacheItem*/IntPtr ppAsmItem, [MarshalAs(UnmanagedType.LPWStr)] String pszAssemblyName); /// <summary> /// Reserved for internal use by fusion. /// </summary> [PreserveSig()] int CreateAssemblyScavenger(out object ppAsmScavenger); /// <summary> /// Installs the specified assembly into the Global Assembly Cache. /// </summary> [PreserveSig()] int InstallAssembly(int dwFlags, [MarshalAs(UnmanagedType.LPWStr)] string pszManifestFilePath, IntPtr pvReserved); } #endregion IAssemblyCache Interface #region FusionHelper Public Class /// <summary> /// Helper class for adding and removing assemblies to and from the GAC. /// </summary> public class FusionHelper { #region Public Constants private const int MAX_PATH = 260; #endregion Public Constants #region API Calls [DllImport("Fusion.dll", CharSet=CharSet.Auto)] internal static extern int CreateAssemblyCache(out IAssemblyCache ppAsmCache, uint dwReserved); #endregion API Calls #region Public Methods /// <summary> /// Adds an assembly to the GAC. /// </summary> /// <param name="assembly">The path and file name of the assembly to add.</param> /// <param name="commitType">The type of installing to perform.</param> /// <returns>Returns true on success, else false.</returns> public static bool AddAssemblyToCache(string assembly, AssemblyCommitFlags commitType) { IAssemblyCache ac = null; // Create a assembly cache item int hr = CreateAssemblyCache(out ac, 0); if (hr != 0) { return false; } else { // Install assembly hr = ac.InstallAssembly( (int)commitType, assembly, (IntPtr)0); if (hr < 0) { Marshal.ThrowExceptionForHR(hr); } // Success return true; } } /// <summary> /// Removes an assembly from the GAC. /// </summary> /// <param name="assembly">The fully specified assembly name of the format [AssemblyName], [Version], [Culture].</param> /// <param name="result">The result of the uninstall request.</param> /// <returns>Returns true on success, else false.</returns> /// <example>Fusion.RemoveAssemblyFromCache("MyAssembly.dll, 1.0.0.0, Neutral", out result);</example> public static bool RemoveAssemblyFromCache(string assembly, out AssemblyCacheUninstall result) { IAssemblyCache ac = null; // Create a assembly cache item int hr = CreateAssemblyCache(out ac, 0); result = AssemblyCacheUninstall.Unknown; if (hr != 0) { // Failed return false; } else { // Uninstall assembly hr = ac.UninstallAssembly(0, assembly, (IntPtr)0, out result); if (hr < 0) { Marshal.ThrowExceptionForHR(hr); } return true; } } #endregion Public Methods } #endregion FusionHelper Public Class
Terms and Conditions
Support this site
Download a trial version of the best FTP application on the internet
