Click here to Skip to main content
Click here to Skip to main content

Shell Extensions for .NET Assemblies

By , 17 Nov 2005
 

About the Shell Extensions for .NET Assemblies

These shell extensions were written to help distinguish between .NET assemblies and Win32 libraries, as well as give extra information about the assemblies without having to drop to a command-prompt to use the SDK and CLR tools. These shell extensions function similar to the loader that makes both .NET and VB (pre-.NET) possible as executable code: the PE/COFF header. As such, the library is very fast and won't hinder your file system browsing experience. A recent update further enhances performance by skipping assembly detection on slow paths, such as UNC paths or drive mappings to remote filesystems via VPN.

Provided in this library are:

  1. Overlay icons for .NET assemblies (.dll)

    Overlay icon 

  2. Column handlers to show the public key token and specific type of .NET assemblies.

    Column handlers 

  3. Automation object for getting the above information in your own applications and libraries.

The Automation Object

Not only does this tool help you distinguish between .NET assemblies and Win32 applications and libraries, but it also provides you with a simple automation object that these shell extensions use.

To generate code from the type library, add a reference or #import the type library named "AsmShell 1.0 Type Library". Use the members of the IAssemblyInfo automation interface as follows:

  • IAssemblyInfo::IsAssembly([in]BSTR path, [out, retval]VARIANT_BOOL* retVal)
    Returns true if the specified file is an assembly, false if it is not, and raises errors when problems occur.
  • IAssemblyInfo::GetFileType([in]BSTR path, [out, retval]FileType* retVal)
    Returns a FileType enumeration member depending on the information for the specified file in the PE/COFF header.
  • IAssemblyInfo::GetPublicKeyToken([in]BSTR path, [out, retval]BSTR* retVal)
    Returns the public key token for the specified assembly.
  • IAssemblyInfo::GetPublicKey([in]BSTR path, [out, retval]SAFEARRAY(BYTE)* retVal)
    Returns the public key as a byte array for the specified assembly. This is not supported by JScript or VBScript, both of which only support an array of VARIANTs.

For each method, late-binding languages like Visual Basic will use the return value (marked with [out, retval]) as the return type of the method, also getting rid of the need for the parameter labeled with the specified attributes above.

So, in VB6 and .NET (C#, VB.NET, et. al.), the methods signatures would look like:

bool IsAssembly(string path);
FileType GetFileType(string path);
string GetPublicKeyToken(string path);
byte[] GetPublicKey(string path);

Requirements

You may be required to reboot if files being installed are currently loaded. If you have Windows XP and the previous condition is false, no reboot should be necessary. If you're using Windows 98, ME, or 2000, you should either log off and back on or reboot your system if the overlay icon is not present; the column handlers should be ready immediately after the installation is finished.

Changes

  • November 17, 2005
    • Note: late article update for an earlier release
    • Added support to display x86 (and MSIL) for assemblies, as well as IA64 and x64
  • May 30, 2005
  • August 29, 2004
    • Added localizability
    • String caching for better performance
    • Support for .NET modules (.netmodule)
  • October 15, 2003
    • Added condition that files should not be parsed for slow paths (ex: VPN)
  • September 19, 2002
    • Initial release to the web on The Code Project

Disclaimer

THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR HIS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

License

This article, along with any associated source code and files, is licensed under The Microsoft Public License (Ms-PL)

About the Author

Heath Stewart
Program Manager Microsoft
United States United States
Heath Stewart is a happily married software engineer originally from the Midwest and a graduate of Iowa State University. Heath start programming early in life and enjoys continuous research and development in new languages, frameworks, and platforms. Fluent in many different programming languages, he has developed many large-scale software solutions for companies in different areas, such as Internet filtering, intrusion detection systems, production management systems, and web applications for various purposes. He also enjoys photography.
 
Currently, Heath is a Program Manager in the Visual Studio Professional Deployment Experience (VSPro DEX) team at Microsoft. Previous to his employment, he was a Microsoft MVP for Visual C#.
 
He is also a CodeProject protector and is happy to help the development community.
Follow on   Twitter

Sign Up to vote   Poor Excellent
Add a reason or comment to your vote: x
Votes of 3 or less require a comment

Comments and Discussions

 
You must Sign In to use this message board.
Search this forum  
    Spacing  Noise  Layout  Per page   
GeneralMy vote of 5 Pinmembermanoj kumar choubey28-Feb-12 18:27 
General64 bit support Pinmembertonyt12-Apr-10 9:21 
GeneralDoes not work an Vista PinmemberglBert25-Jun-08 7:39 
General[Message Removed] Pinmembernompel1-Oct-08 7:40 
GeneralVS 2005 crashing PinmemberMiroslav Havram6-May-06 16:14 
GeneralRe: VS 2005 crashing PinprotectorHeath Stewart8-May-06 6:14 
GeneralRe: VS 2005 crashing PinmemberMiroslav Havram8-May-06 11:14 
GeneralGreat DLL and Handy tool PinmemberDaniel@SA25-Apr-06 3:18 
QuestionOld MSI Necessary to Install New Version? PinmemberStephen Quattlebaum13-Oct-05 4:51 
AnswerRe: Old MSI Necessary to Install New Version? PinprotectorHeath Stewart13-Oct-05 5:01 
AnswerRe: Old MSI Necessary to Install New Version? PinmemberStephen Quattlebaum14-Oct-05 7:40 
GeneralRe: Old MSI Necessary to Install New Version? PinprotectorHeath Stewart14-Oct-05 7:59 
GeneralInterface PinmemberHipSvin29-Sep-05 0:41 
AnswerRe: Interface PinprotectorHeath Stewart29-Sep-05 5:45 
GeneralRe: Interface Pinmemberhipsvin29-Sep-05 22:39 
AnswerRe: Interface PinprotectorHeath Stewart30-Sep-05 10:33 
GeneralRe: Interface Pinmemberhipsvin30-Sep-05 13:59 
AnswerRe: Interface PinprotectorHeath Stewart30-Sep-05 19:48 
GeneralRe: Interface Pinmemberhipsvin3-Oct-05 1:45 
AnswerRe: Interface PinprotectorHeath Stewart3-Oct-05 8:40 
GeneralRe: Interface Pinmemberhipsvin3-Oct-05 10:36 
GeneralIcon Location PinmemberSameers (theAngrycodeR )25-Sep-05 10:40 
GeneralRe: Icon Location PinprotectorHeath Stewart25-Sep-05 14:54 
GeneralRe: Icon Location PinmemberSameers (theAngrycodeR )26-Sep-05 0:21 
AnswerRe: Icon Location PinprotectorHeath Stewart26-Sep-05 4:24 
GeneralRe: Icon Location PinmemberSameers (theAngrycodeR )26-Sep-05 10:23 
AnswerRe: Icon Location PinprotectorHeath Stewart26-Sep-05 11:15 
GeneralRe: Icon Location PinmemberSameers (theAngrycodeR )26-Sep-05 11:19 
AnswerRe: Icon Location PinprotectorHeath Stewart26-Sep-05 11:25 
GeneralSoftware Design Engineer... Pinmemberbcraun1-Jun-05 8:35 
GeneralRe: Software Design Engineer... PinprotectorHeath Stewart1-Jun-05 11:34 
GeneralOverlay Icon PinmemberZenly17-Jan-05 10:07 
GeneralRe: Overlay Icon PinprotectorHeath Stewart17-Jan-05 10:41 
This shell extension looks for PE/COFF data that determines whether the file is a managed assembly. It does not set overlay icons and is not a general purpose overlay icon.
 
To implement such an overlay would not be a good idea. Every file class (that is, "*" in the registry) would require registration for your overlay icon, which means Explorer would query your icon handler for EVERY SINGLE FILE on the file system that appears in Explorer for the default folder views (other view servers may not query for such information). You would have to index file paths efficiently, too, using - perhaps - a Trie (pronounced "try") data structure for efficient lookups. Using managed code for such a task would additionally be a bad idea since you have several MBs of RAM in overhead and many more instructions to process (even once JIT'd to native code).
 
If you want overlay icons then I suggest you implement them for your file classes (types). If you want to write a general purpose text editor than save your files as text but with a different extension. Or, save them using ".txt" and write an overlay icon handler for ".txt" but not for all file classes. Even in native code this would drag-down a system.
 
This posting is provided "AS IS" with no warranties, and confers no rights.
 
Software Design Engineer
Developer Division Sustained Engineering
Microsoft
 
[My Articles] [My Blog]
GeneralRe: Overlay Icon PinmemberZenly17-Jan-05 12:57 
GeneralRe: Overlay Icon PinprotectorHeath Stewart17-Jan-05 13:15 
GeneralRe: Overlay Icon Pinmemberhullion23-Nov-05 2:36 
AnswerRe: Overlay Icon PinprotectorHeath Stewart23-Nov-05 6:24 
GeneralDoesn't work on Win98! Pinmemberjdunlap15-Oct-03 9:40 
GeneralRe: Doesn't work on Win98! PineditorHeath Stewart15-Oct-03 11:47 
GeneralRe: Doesn't work on Win98! Pinmemberjdunlap15-Oct-03 14:06 
GeneralRe: Doesn't work on Win98! PinprotectorHeath Stewart30-May-05 11:46 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Mobile
Web04 | 2.6.130619.1 | Last Updated 17 Nov 2005
Article Copyright 2002 by Heath Stewart
Everything else Copyright © CodeProject, 1999-2013
Terms of Use
Layout: fixed | fluid