Developing For .NET

Several years ago when ClickOnce first emerged I thought it was a great idea.  Unfortunately at the time, I found it so difficult and tedious that I didn’t play with it for long.  My buddy Stuart was at my office recently and I was lamenting some distribution issues I was having with one of our WPF apps. 

One of our deployed apps changes frequently, and I don’t send out updates as often as I should because our users environments typical limit their install rights (not to mention many of them don’t even have IT staffs).  This means they rarely have the latest and greatest because it can be a serious ordeal to deploy the changes.  Stuart brought up ClickOnce, and the discussion quickly came to the question “what happens when the user doesn’t have administrator rights?”  Naturally, we had to put this to the test!

What I love about ClickOnce

I love how easy it is to setup and use – We spent about an hour playing with ClickOnce and I was amazed to find how far the tooling has come since I last checked it out.  The setup is pretty straight forward, so I’m not going to cover that right now.  If you specifically want me to write a post or do a video about it, respond in the comments below.

I love the control that I have – The options are pretty sophisticated: you can make an application available online only or online and offline.  When you make one available offline it creates a Start Menu option for you.  You can select Prerequisites, like the .NET Framework version, and where to download them if they aren’t present at install time. NOTE: Some caveats may apply to that, like needing administrator rights to install the Framework.

I love Automatic Updates – You can configure the application to automatically check for updates, the exact feature I needed.  You can configure when to check for updates, how often, etc.  You can even configure it NOT to check for updates.  I set mine to check for updates every time the application starts, which will prompt the user to install the new version before the software executes.

I love that users without administrator rights can install apps – This is a huge win for us.  We did a little testing and found that a user without Administrator rights can install these applications.  I presume this is because they operate in some kind of a sandbox, but I don’t actually know.  Pssst: if this is a bug, please don’t tell Microsoft – I love this feature!

Again, I was struck by how easy all this was to setup and configure, and once again I’m beating myself up for all the time I spent NOT using a supplied feature.

What I don’t love about ClickOnce

So far I have discovered two things I don’t like about ClickOnce: the first is that while I can easily create a desktop shortcut, I don’t seem to have any control over the Icon that gets displayed.  Even more strange is that the icon that is being displayed is a Blend icon of some sort.  It seems to me that this would be a pretty common requirement, so I’m surprised there isn’t a readily apparent way to assign an icon.

But far worse than that is the fact that conventional wisdom says that ClickOnce applications can’t handle command line arguments.  This was a deal breaker for me: virtually all of our desktop apps need to be executed from AS/400 sessions.  These sessions pass arguments into the applications via the command line, and losing that capability would negate most of the value of the software.  While I’m sure I’ll figure out the Icon issue, the command line arguments problem needed addressing immediately.

Command Line Arguments

So it is not entirely true that ClickOnce applications can’t handle command line arguments, but until .NET 3.5 SP1, they could only handle them as query string parameters.  This underscores the fact that ClickOnce is a heavily network dependent technology.  You may get an application that installs on your machine with a Desktop Shortcut, but this is still a network deployed application, and as such it relies on some URI scheming.  For me, this isn’t going to help much, so what I was after was the ability to pass in arguments in offline mode using a more traditional approach, like C:\> MyApp.exe arg1 arg2 arg3

I want to get to the nitty gritty of the blog post, so I won’t go into all the details, but here are a few things you need to know:

• You have no idea where the app is actually installed.  If you do manage to find it, it will have a user-unfriendly name
• The Shortcut name is the same as the “Product Name” field in the Publish Options Description in the ClickOnce configuration
• The Shortcut on the Desktop has a special extension: .appref-ms
• The easiest way to execute the application from the command line is like so: C:\> %userprofile%\Desktop\AppName.appref-ms
• If your “Product Name” has spaces, you will need to wrap that in double quotes: C:\> “%userprofile%\Desktop\My App Name.appref-ms”

What would be perfect is if I could just append the Command Line Arguments to the end of that call, so it would look like this: C:\> “%userprofile%\Desktop\My App Name.appref-ms” arg1 arg2 arg3

Try it out, though, and you’ll quickly find that this does nothing: the standard args string array is empty.

Not A New Problem

Naturally I hit the Interwebs in search of a solution, I mean, it has to be out there, right?  I was quickly discouraged though to find hundreds of references all saying the same thing: you cannot pass command line arguments to an offline ClickOnce application.

Go ahead, go search for yourself, I’ll wait.

…

See what I mean?  The question has been asked a million times all with a resounding NO as the answer.  I was about to give up when I spotted something that gave me hope.  An article on MSDN entitled How to: Retrieve Query String Information in an Online ClickOnce Application has a note block with the following text:

Starting in .NET Framework 3.5 SP1, it is possible to pass command-line arguments to an offline ClickOnce application. If you want to supply arguments to the application, you can pass in parameters to the shortcut file with the .APPREF-MS extension.

That sounds like exactly what I want!  Problem is, I’ve already tried that and it doesn’t work.  And naturally, there is no related article on MSDN telling me how to do it, just that it can be done.  Finally, something to give me a little hope!

Finally, I hit the mother lode: an article by RobinDotNet explaining How to pass arguments to an offline ClickOnce application.  Robin’s blog is all about ClickOnce, and interestingly enough I found plenty of earlier posts and forum entries by Robin stating this couldn’t be done, even as late as January 2010, long after .NET 3.5 SP1 was released.  I’m not criticizing, but I am pointing out that even to those “in the know” it would appear this is a non-documented feature.

A Simple Solution

So I read through RobinDotNet’s post and it seemed like a lot of stinking work, and I try to avoid that as much as possible!  She explains a bunch of stuff I didn’t need, like how to locate the shortcut using SpecialFolders, and ho
w to programmatically execute the application.  She even discusses how to create and pass the arguments.  Good stuff, but overkill for me.

There is one key line of code I found in her post that was exactly what I needed:

//Get the ActivationArguments from the SetupInformation property of the domain.
string[] activationData =
  AppDomain.CurrentDomain.SetupInformation.ActivationArguments.ActivationData;

What I found is that this will return the arguments provided on the command line.  Well, sort of …

From the code above you can see that ActivationData is a string[].  At first, I assumed I would be able to simply replace the old e.Args with this value, but I found that only the first argument is available in ActivationData.  I don’t know why this is, and it doesn’t make sense, but all my testing proved this out.

To solve this, I changed the way the arguments are passed in by making them comma delimited.  It doesn’t seem to matter what delimiter you use, as long as it isn’t a space.  Then, I parse ActivationData[0] using Split.  In the code sample below, I am also checking to see if this is a ClickOnce application and checking for NULL, the default value of ActivationData if no arguments are passed.

string[] args = null;
if (ApplicationDeployment.IsNetworkDeployed)
{
    var inputArgs = AppDomain.CurrentDomain.SetupInformation.ActivationArguments.ActivationData;
    if (inputArgs != null && inputArgs.Length > 0)
    {
        args = inputArgs[0].Split(new char[] { ',' });
    }
}
else
{
    args = e.Args;
}

I assume if I wanted I could still deploy this with a traditional MSI, so doing it this way supports compatibility with a traditional command line execution. In this case, I am parsing it to build another string[] because I have existing code that works with Command Line Arguments.  This example is executing inside my WPF application’s App.xaml.cs file’s Application_Startup event handler.

Getting it to work in .NET 3.5 SP1

In order to get the code above to compile, you will need to add a reference to System.Deployment.Application, which is in System.Deployment.dll.  If you are coding against .NET 4.0, this DLL is available in the “Add Reference -> .NET” dialog.  When I tried to add the reference to an existing .NET 3.5 application, the DLL was not available in the list.  I thought this was a little strange, since the documentation claims it is supported as far back as 2.0.

I did a little digging and found the DLL location.  I was then able to Browse for the DLL and add a reference to it manually and everything seems to work:

C:\Windows\Microsoft.NET\Framework\v2.0.50727\System.Deployment.dll

The Results

The results are just what the doctor ordered: I can now call my application from the command line and pass it arguments like so: C:\> “%userprofile%\Desktop\My App Name.appref-ms” arg1,arg2,arg3

It’s not perfect, but it is easy.  The biggest change is sending all the arguments as a single string, but that is easily handled.  Now if I can just figure out that Icon …

I’m happy to announce an event that I have been working on with Kevin Griffin, president of the Hampton Roads .NET User Group (HRNUG).

One of the frustrating things for me as a Blend Speaker and self-proclaimed “Blend Evangelist” is that at most Code Camps or User Groups I just don’t feel like I have enough time to really dig in and show as much Blend goodness as I would like.  And my presentations always run long because I’m just so excited and I hate to leave anything out!

Last year I was lamenting the situation to Kevin, and he joked around and said we should have a “Joel Camp” so I could talk about Blend all day long.  We’ve had a lot of laughs about that ever since, but as time went on we got a little more serious about it.  After one Code Camp, where I had submitted 5 separate Blend presentations, the idea of a “Blend Camp” became something we were seriously discussing.

That was last fall, and no one’s schedule was allowing any such event to go forward.  Intrigued by the idea, I also began thinking about putting a site together dedicated to hosting Blend Tutorial Videos.  I even purchased a domain name and some hosting access, but time and laziness being what they are, I never got very far in the project.

Meanwhile, Back at the Ranch…

So between all the Code Camps and other things going on in the Mid-Atlantic, the idea of an all day event just kept losing ground.  Fortunately, Kevin never quite forgot the idea and he came up with a viable alternative: instead of one long day, what if we did a week of lunch and learn webcasts? That’s great! I can do that! 

And so I am proud to announce the first ever Blend-O-Rama! Kevin and HRNUG are going to host the event on LiveMeeting, and I will be giving the presentations.  We are going to do one presentation each day, Monday through Friday, July 19th – 23rd,  from 11:30 to 1pm EST.  Each day will cover a different topic:

July 19th – An Introduction to Expression Blend
Microsoft Expression Blend is the premier GUI editor for WPF and Silverlight applications.  In this presentation you will receive an introduction to the Blend UI and how to use it to quickly and easily build an application interface.  Topics will include Configuration, Layout Controls, how to leverage Blend with Visual Studio, and more.

July 20th – Data Binding in Expression Blend
Data Binding is one of the key features of WPF and Silverlight.  This presentation demonstrates and explains the Data Binding tools and features of Blend.  Includes discussions of Data Context, Value Converters, Element Binding, Sample Data and more.  With these tools you really can bind anything to anything.

July 21st – Templating in Expression Blend
An introduction to using Microsoft Expression Blend to leverage Templating in WPF and Silverlight applications. Templates provide a powerful way to enact GUI changes in the application presentation layer without requiring code behind manipulation. The power of Templating provides unlimited potential for enhancing your GUI.

July 22nd – Animating Business in Blend
Discusses how to use animation to enhance line of business applications and demonstrates how to create and employ them in Blend. Topics will include Animations, Triggers, Events, and the Visual State Manager.

July 23rd – Advanced Topics in Blend
Discusses how to take Blend to the next level. Topics will include Behaviors, Graphic manipulations, Audio and Video, Theming, and more.

Registration is now Open

The most awesome news of all is that, thanks to HRNUG, this event it totally FREE!  Registration for the event is now open.  You can also click on the banner in the sidebar or this page, or watch Kevin’s website or HRNUG’s website for more details.  Please pass the link around, tweet about it, etc., everyone is welcome!  And through the magic of LiveMeeting we will be fielding questions from you the audience!

Drum Roll Please …

I’m probably going to regret this later, but remember that Video Tutorial website I mentioned above? Today I am officially announcing that I will launch the website during the event.  Who knows, it worked for getting my certification: maybe setting a date will be the motivation I need to finally get the website going!