I've been meaning to look more into building a Sidebar Gadget in Vista for a while now. I just happened to come across a post from Nikhil Kothari's blog entitled Authoring Sidebar Gadgets in C#. I don't really have the time to the follow longer, in-depth tutorials you see around and was interested to see how his Script# project allowed the use of C# when building a Gadget. Worth a closer look I think.

As your solution grows, the number of assemblies you have will undoubtedly grow too. Updating the version numbers of all those assemblies by their projects AssemblyInfo.cs files can be a hassle. However, there is a way to change the version in just one file, but have that change affect all project assemblies!

By using a “link” file in your projects, you can include a file from a shared location that contains only the version information.

• Add a new file named VersionInfo.cs
• Add to this file only the version information from an existing AssemblyInfo.cs file
  <
• Add VersionInfo.cs as a solution item

Now, for each project that you wish to include this version information:

• Select “Add Existing Item…” on the project menu
• Browse to VersionInfo.cs file
• Click the down arrow on the “Add” button and choose “Add as Link”
  
  The file will have the shortcut icon when you look at the project files.
  
• Remove any version information from existing AssemblyInfo.cs

When then assembly is built it will essentially have the combined attribute values from the AssemblyInfo.cs and VersionInfo.cs file.

Now you only have to change the version in one place and all projects will get it :-)

I always thought it was strange that the “Build Code Comments” feature was missing from VS2005. What with the alternative comment generators being unable to cope too well with .NET 2.0 code, we were left with little option. NDoc was the best of the lot, but still had a couple of problems with generics and it was difficult to find a good working version to tweak.

Good news however. The first CTP of Sandcastle (which I assume is just the codename) will be released by Microsoft later this month or early next.

It’s what they use internally for their MSDN content so it can’t be at all bad, although why couldn’t it have been released sooner with the launch of VS2005 I don’t know?

Interestingly too, Kevin Downs, the developer behind NDoc, has apparently announced that he is no longer going to be working on NDoc.

Update:
You can now download it from here.

I was shown a nice little trick today by a collegue who was trying to debug a Windows Installer CustomAction. The problem of course is that you can't debug the code because it is being launched and controlled by the Windows Installer/MSI. The trick is to add the line below somewhere in the code:

          

            System.Diagnostics.Debugger.Break();
          
        

When this line is executed an "exception" is thrown, which launches the Visual Studio dialog asking you if you wish to debug the process as there is an exception. Now you can simply attach to your Visual Studio session and debug your code as normal! Nice trick, that after nearly 5 years of working with .NET, I had not come across.

It's worth noting that execution will continue after the Break method is called, so you need to have a normal breakpoint ready when you attach to the VS session.

I discovered today that Microsoft has launched MSDN Wiki . I was using fxCop and reading into some of the details for the rules that it said I was breaking :-). Normally you are taken to msdn2 help system, but was instead taken to the Wiki version.

The core reference is taken from exactly the same database as all the other MSDN help systems, but currently can only seemed to be accessed via the web site. I've always found the online documentation from Microsoft difficult to search and navigate, so I tend to use the thick client version of MSDN Library. It would be good to be able to link to the MSDN Wiki from the thick client (for online help searches of course) to make it a little better for searching.

All in all, it's such a great idea to be able to amend the documentation. I've lost count of the number of times that the .NET Compact Framework documentation was incorrect, misleading or just plain missing! However, until they make it easier to search, I'll be sticking to MSDN Library, but will be keeping tabs on the blog for updates.

It's taken a while, but I finally found a blogging system that I liked.

ThinkJot is an ASP.NET 2.0 version of the latest release of the dasBlog engine. The reason for the split is that when running under ASP.NET 2.0, your site is running by default under "Medium Trust" rather than "Full Trust", which was the case in .NET 1.1. If you're running on a shared host as I am here, you'll probably find that it is running under the default security settings. No problem you think ... well, try running dasBlog 1.8 under "Medium Trust" and you'll find it doesn't work! It turns out that even things such as the date picker used, did some things that needed to run under Full Trust. For the full story go to the blog.

That's where ThinkJot comes in. It was simply a rebuild and tweak to make it ASP.NET 2.0 and Medium Trust friendly. I pass my thanks on now to the guys at Process64 who did this, you saved me a job!