The best kept secret in Redmond, WA are the new T4 Preprocess Text Templates that shipped in Visual Studio 2010 Beta1 and Beta2.  In just a few minutes you’ll be in the know and using them.

Background – Condensed

T4 = text template transformation toolkit

T4 templates have been available since Visual Studio 2005 and are part of DSL (Domain Specific Languages) documentation.

In Visual Studio 2010 the templates are MUCH easier to use because they are preprocessed.  When you save your T4 template, it is compiled.  The T4 template is now “processed” at compile time.  This was not the case in previous releases.

Your compiled template is just another type in an assembly that you can now instantiate and call its single method, TransformText.  The only run-time requirement to use T4 templates is the .NET 2.0 Framework.

Prerequisites

• Visual Studio 2010
• T4 Editor Plug In 
  • Visual Studio 2010 does not provide any editing assistance when editing T4 templates (.tt files).  You can search the Internet for T4 Editor and you’ll find some information and products.
  • I’m currently using the Tangible T4 Editor (free) that you can get on the Visual Studio Gallery here: 
    • http://visualstudiogallery.msdn.microsoft.com/en-us/60297607-5fd4-4da4-97e1-3715e90c1a23
    • The editor is an Alpha version, has a few limitations but I was able to author the below template in a few minutes.

Our Scenario

We have been tasked with creating some code that we can pass data fields to and that code will create a VB.NET property.  This code will be part of a larger program that is fed information and creates class files.

Before T4 Preprocessed templates we had several options available to us.  Write code to spit out the required property, buy a 3rd party product, use CodeDom, etc.

Since we just installed Visual Studio 2010 Beta2, we are going for the productive, inexpensive, simple and out of the box solution, T4 Preprocessed Text Template.

Our Test Bench

This simple application simulates the data harness that will ultimately feed our T4 template and consume its output.  Set a few data fields and press Generate Code.

Code Generation – It’s all about the data

Code generation requires metadata to drive the output.  With the new T4 templates, getting metadata into your T4 template is a simple matter of a partial class.  The members in the partial class are available at design time and run-time.  I know this seems so simple, but T4 did not always work this way.  Now you have full design time strong typing and instant compile time verification of your template and code.

To keep this example as simple as possible, I’ve exposed the metadata directly as properties and passed values for them in the constructor of our Partial Class PropertyTemplate.  For simple scenarios this totally fine.  For a larger or multi-language code generation applications, a better solution is to expose the metadata through an Interface.  The Interface type can contain metadata and helper methods that can be used in your T4 template.

Kathleen Dollard and I have spoken a good bit about this and think using Interfaces for metadata and helper methods makes the most sense.  I’m sure Kathleen will write more on this subject and I know I will.

In the below T4TemplateLibrary project you can see how I’ve set up the project.  I had to turn on “Show All Files” to see the hidden file, “PropertyTemplate.vb” below the “PropertyTemplate.tt” file.

Open the hidden “PropertyTemplate.vb” file up and you will see the type of code you and I used to have to write to generate code.  Now T4 does it for us!

The below partial class is overly simple and exposes metadata that will be consumed by the T4 template.

Namespace My.Templates

  Partial Public Class PropertyTemplate

    Public Property PropertyName As String = String.Empty
    Public Property BackingField As String = String.Empty
    Public Property TypeName As String = String.Empty
    Public Property IsShared As Boolean = False
    Public Property RaisePropertyChangedMethodName As String = String.Empty
    Public Property IsReadOnly As Boolean = False
    Public Property Scope As String = String.Empty
    Public Property IsSetterPrivate As Boolean = False

    Public Sub New(ByVal strScope As String, ByVal bolIsShared As Boolean,
                   ByVal bolIsReadOnly As Boolean, ByVal bolIsSetterPrivate As Boolean,
                   ByVal strPropertyName As String, ByVal strBackingField As String,
                   ByVal strTypeName As String, ByVal strRaisePropertyChangedMethodName As String)
      Me.Scope = strScope
      Me.IsShared = bolIsShared
      Me.IsReadOnly = bolIsReadOnly
      Me.IsSetterPrivate = bolIsSetterPrivate
      Me.PropertyName = strPropertyName
      Me.BackingField = strBackingField
      Me.TypeName = strTypeName
      Me.RaisePropertyChangedMethodName = strRaisePropertyChangedMethodName
    End Sub

  End Class

End Namespace

T4 Template

To add a T4 template to your project, select Add New Item, then type “preprocessed” in the search box.  Select the Preprocess Text Template.

If you used classic ASP, then T4 template editing is a skill you already have.  In classic ASP we used <% and <%=.  In T4 we use <# and <#=.  The reason for this change is so that T4 can be used to generate classic ASP and ASP.NET code.  If you didn’t have the joy of shipping classic ASP web sites, no worries.  15 minutes of trail and error and you’ll be fully qualified.

The below image shows the free Tangible T4 Editor Plug-In IntelliSense in action.  It provides IntelliSense for T4 directives and template specific constructs like <#.  It also colorizes the template code.  Colorizing makes editing the template much easier too.  One current limitation is that its IntelliSense engine does list member properties defined in the partial class for the template.

The below code block is the T4 template.  It has a language directive at the top followed by static text and code blocks.

<#@ template language="VB" #>

<#= Me.Scope #><#= IIF(Me.IsShared, " Shared","") #><#= IIF(Me.IsReadOnly, " ReadOnly", "") #> Property <#= Me.PropertyName #> As <#= Me.TypeName #>
    Get
        Return <#= Me.BackingField #>
    End Get
<# If Not Me.IsReadOnly Then #>
    <#= IIF(Me.IsSetterPrivate, " Private ","") #>Set(ByVal value As <#= Me.TypeName #>)
<# If String.IsNullOrEmpty(Me.RaisePropertyChangedMethodName) Then #>
        <#= Me.BackingField #> = value
<# Else #>
        <#= Me.BackingField #> = value
        <#= String.Format("{0}(""{1}"")", Me.RaisePropertyChangedMethodName, Me.PropertyName) #>
<# End If #>
    End Set
<# End If #>
End Property

<#=  is the same as the ASP Response.Write.  It writes the result of the expression into the template.  For example, if the Scope is Public, <#= Me.Scope #> would yield Public when the template is transformed at run-time.

<# is the beginning of a code block.  Notice how the IsReadOnly property is tested.  Basic on the result, an entire block of code can either run or be by-passed.  This feature is so cool when you bring loops from LINQ queries into the picture.

One thing you’ll notice is that all the code blocks are left justified.  Yes, this makes reading the template a little harder.  However, if you don’t do this, the resulting code will be indented the same amount as the code block indentation.

So what I do when editing my templates is to indent everything to make it easier to edit the template.  When I”m done, I go back and move the code to the left.

Run-Time Rendering of T4 Templates

Dim t As New PropertyTemplate(
    Me.cboScope.SelectedItem.ToString,
    Me.chkIsShared.IsChecked.Value,
    Me.chkIsReadOnly.IsChecked.Value,
    Me.chkIsSetterPrivate.IsChecked.Value,
    Me.txtPropertyName.Text,
    Me.txtBackingField.Text,
    Me.cboTypeName.SelectedItem.ToString,
    Me.cboRaisePropertyChangedMethodName.SelectedItem.ToString)

'How cool is this?  Instantiate, call a single method, get the code!
Dim strResult As String = t.TransformText

Instantiate the template, call the TransformText method.  Not very sexy, but powerful!

Download

Get Your T4 On Demo Application (33KB)

Alternate Download Site

Some corporate firewalls do not allow access to Windows Live Sky Drive. You can download the installer here. Remember to rename the file from .doc to .zip. This is a requirement of WordPress.

Get Your T4 On Demo Application (33KB)

Links

Gareth Jones blog  Gareth works on the DSL Team at Microsoft and works with the Microsoft T4 product.

Kathleen Dollard’s blog Kathleen has been doing code generation for a very long time and is an industry expert in this space.

Kathleen Dollard’s work blog post on why T4 Templates are the best thing since sliced bread.

Oleg Sych very nice blog post on T4 Preprocessed Text Templates

Pablo Galiano T4 Preprocessing Part 1

Pablo Galiano T4 Preprocessing Part 2

Close

There is a fair amount of information on Visual Studio 2005/2008 T4 templates.  When reading these blog posts, magazine articles and MSDN Documentation, keep in mind that the new T4 templates do not have wide spread documentation yet.  Most of what you will find is applicable to editing of the templates and directives used in the templates.  Beyond that, just filter the information and you’ll stay on course.

Visual Studio 2010 T4 Preprocessed Text Templates are a great tool for your toolbox.  Hope to see you use the best kept secret in Redmond.

Have a great day,

Just a grain of sand on the worlds beaches.

I have updated the project templates Visual Studio 2010 Beta2 Sample Data Project Templates. 

The Silverlight template needed an update to the .proj file.

Please download the templates from the above post.

Sorry for the problem.

Close

Have a great day,

Just a grain of sand on the worlds beaches.

I was working on a post for T4 Preprocessed Text Templates (I’ll post it tonight) and found a bug in the XAML Power Toys for Visual Studio 2010 Beta2 Cider Designer grid parsing code. 

Chances are you won’t hit it, but I did so I’ve corrected the code and posted a new update.  The code didn’t properly handle a null value in the CheckBox.Content property.  I’ve correct it and added additional null checks.

Please visit this page XAML Power Toys for Visual Studio 2010 Beta2 Cider Designer and get the latest version v1.0.1.

You can go to the above page, download the install files and install overtop as it will remove the previous version and install the new one.

Sorry for the bug. 

Close

Hope you use and enjoy XAML Power Toys for Visual Studio 2010 Beta2 for Cider.

Have a great day,

Just a grain of sand on the worlds beaches.

The WPF and Silverlight Designer for Visual Studio 2010 shares several new design time (d:) properties and design time MarkupExtensions with Expression Blend 3 that provide necessary information for the WPF and Silverlight Designer to deliver a great editing experience.

I have explained the d:DesignData MarkupExtension in detail in this blog post:  Visual Studio 2010 Beta2 Sample Data Project Templates.

In this post I’ll cover the d:DataContext property and the d:DesignInstance MarkupExtension.

d:DataContext

d:DataContext gives developers the ability to set a design time d:DataContext that is separate and independent of the run-time DataContext property.

This feature solves the problem of developers wanting to set their DataContext programmatically but also wanting design time data.

All d: properties are ignored during compilation and are not part of any run-time assemblies.

d:DesignInstance

Purpose:  Provides a design time shape to the d:DataContext its applied to.

Example:  In the below snippet the Person class is the shape provided by d:DesignInstance to the Grid’s d:DataContext.

<Grid d:DataContext="{d:DesignInstance local:Person}">

Note: In the above example, the Person class is actually a faux type (fake or substitute type).  This faux type enables types that are not creatable to be created and their properties exposed as a shape.  See the below section on creating creatable types.

Usage:  So, now that the d:DataContext has shape, what can I do with it?

The shape is used by the new Binding Builder to expose the properties of the type in d:DataContext.  You can see in the below image, the four properties exposed by the Person class.

The Binding Builder is opened by clicking or right clicking on the Property Marker in the Properties Window.  The Property Marker is the icon to the right of the property name.  The Binding Builder is a GUI for editing bindings in WPF and Silverlight.  This is a super feature

The Cider Team has a great explanation of the new features on WindowsClient.net that you can read here: Setting Up Visual Studio for WPF and Silverlight Development.  There is an article and video.

You can read additional Cider Team Online material here:  WPF and Silverlight Designer for Visual Studio 2010.  We are in the process of adding many more articles.  While the material is initially geared for developers coming from other platforms to WPF or Silverlight, it has a lot of great information even for the seasoned XAML Head.  Yea, I said it.  I’m a XAML Head too and proud of it.  (LOL)

Without d:DesignInstance, d:DesignData or d:Source applied to a CollectionViewSource the Binding Builder would have no way to determine shape and provide a list of properties.

Note:  If d:DataContext is not set, but DataContext is set and has a created type assigned to it, this will also supply shape that the Binding Builder can use for listing properties.

Creating Creatable Types

 <Grid d:DataContext="{d:DesignInstance local:Person, IsDesignTimeCreatable=True}">

d:DesignInstance provides a technique for creating a non-faux type.  Setting the property IsDesignTimeCreatable to True on the d:DesignInstance MarkupExtension enables this.

Links

MSDN d:DesignInstance Walkthrough

Video showing d:DesignData and d:DesignInstance can be viewed from this blog post:  Visual Studio 2010 Beta2 Sample Data Project Templates.

The above post also has source code for sample data templates.  There four of the templates are tutorial walkthroughs on this topic and sample data.

The two .xaml files in the DesignInstance Samples folder are the walkthroughs.  You can create this project in VB.NET or C# by using one of the below templates when creating your project.

• VB WPF Application DesignData Sample – VB.NET Sample WPF Application that demonstrates consuming sample data.
• CS WPF Application DesignData Sample – C# Sample WPF Application that demonstrates consuming sample data.

Close

Hope you find d:DesignInstance and d:DesignData Sample Data in Visual Studio 2010 Beta2 a productive feature for your application development.

Have a great day,

Just a grain of sand on the worlds beaches.

To get to this Options dialog, use the Tools menu, selected Options, select Text Editors, select XAML, select Miscellaneous.

MarkupExtension IntelliSense and Editing

The most requested feature for the WPF & Silverlight XAML Editor was MarkupExtension IntelliSense.  This feature has been added to Visual Studio 2010 Beta2.

In addition to IntelliSense you also get some entry helpers.

1.  When you type a { (left curly brace) Visual Studio will automatically insert the } (right curly brace) for you. 

You can disable this feature by un-checking the above option, “Closing braces for MarkupExtensions.”

2.  When you press the SPACEBAR inside {} (curly braces) Visual Studio will automatically insert a comma for you to the left of the space added by pressing the SPACEBAR. 

You can disable this feature by un-checking the above option, “Commas to separate MarkupExtension parameters.”

Toolbox Auto-Population

Visual Studio 2010 Beta2 now adds all Custom Controls and UserControls in the Solution to the Toolbox when you build the solution.  Control’s are added to a separate Toolbox tab for each project. 

You can disable this feature by un-checking the above option, “Automatically populate toolbox items.”

How Auto-Population Works

When you build a project, its corresponding tab in the Toolbox is cleared and then all types that derive from FrameworkElement are added to the Toolbox tab for that project.  (see Fine Print below for more details)

When you build the solution, all projects Toolbox tabs are updated as explained above.

If you want to prevent an item from appearing in the Toolbox during the Auto-Population processing decorate the class with the System.ComponentModel.DesignTimeVisible attribute and pass False in the constructor.

The following code snippet shows the DesignTimeVisible attribute decorating the CustomView UserControl.  The CustomView UserControl will not appear in the Toolbox.

Imports System.ComponentModel

<DesignTimeVisible(False)>
Public Class CustomerView
    Inherits UserControl

End Class

Fine Print

To appear in the Auto-Population Toolbox process a type must derive from FrameworkElement and:

1.  Are public and have a default public or internal constructor or are internal and have either a default public or internal constructor

3.  Types deriving from Window or Page are ignored

4.  FrameworkElements in other .exe projects are ignore

5.  Internal classes will only be displayed when the active designer is for an item in the same project

6.  Friend Assemblies are not taken into account for Toolbox Auto-Population

Close

Have a great day,

Just a grain of sand on the worlds beaches.

Current Version 1.0.1, Last Update 28 October 2009

These last few weeks I’ve been writing control designers for Visual Studio 2010 Beta2 WPF and Silverlight controls.

Turns out this is much easier than I expected and is a lot of fun too!

This application is an example for writing a globalized WPF & Silverlight platform neutral control designer.  Both WPF & Silverlight applications use the same Design library.  You can check out the source code to see how this is done.  This source code is in VB.NET.  Later this week, I’ll be posting another full featured article and code example in C# and VB.NET for writing a platform neutral control designer for WPF & Silverlight custom controls.  The project also includes two controls you can use in your projects.  (Yes, Karl now speaks C#.  Took about 2 days to pick it up.  Still have to lookup some syntax but pretty fluent now.)

I must give credit where credit is due.  I got a good bit of feedback and suggestions from my teammates on the Cider Team (WPF & Silverlight Designer Team).  Thanks Mark, Zhanbo, Bin, Pav, Marco, Ben  and Ray.  My great friend Josh Smith also came over one day for some pair programming activities.  Thanks Josh!

For those that care, the above designer is an MVVM application that is completely data driven from the ViewModel.

Grid Layout Tool

The Grid Layout Tool provides an abstract view of the selected Grid control in the designer that enables editing the Rows and Columns of the selected Grid.

The above image is the Grid Layout Tool that allows you to:

• Move (reorder) rows and columns
• Move (reorder) multiple rows and columns (when multi-selected with CTRL+click)
• Insert row or column before or after any row or column
• Delete row or column
• Set all row or all columns sizes using the TextBoxes at the top.  Enter value and press ENTER.
• Set individual row or column size by clicking the text value the Azure row or column headers and then editing them.  Enter value and press ENTER.
• To set size to auto type “a” or “auto” and press ENTER.
• Designer is updated real time as you make your changes.
• Clicking the “Save” button commits the changes into one Undo Transaction.
• Clicking the “Cancel” button cancels all changes and puts the designer back in its original state.

Menu Options

This menu is only available when you have selected a GRID control in the WPF or Silverlight designer.

Chainsaw – Leaves Alignment

The chainsaw will remove all Margins, MinHeights, MinWidths and from CheckBox, RadioButton, Label, TextBlock will remove height and widths and on TextBox will remove height.  Will set all Grid Rows to Auto.  Will remove Name and x:Name if enabled.

Use this command if you do not have styles defined that determine layout for your form.  (see video)

Chainsaw – Clears Alignments

The chainsaw will remove all HorizontalAlignments, VerticalAlignments, Margins, MinHeights, MinWidths and from CheckBox, RadioButton, Label, TextBlock will remove height and widths and on TextBox will remove height.  Will set all Grid Rows to Auto.  Will remove Name and x:Name if enabled.

Use this command is you have a styles defined that determines layout for your form.  (see video)

Modify Control Tags on Create

If this option is checked the following controls will be affected when you create the control using the ToolBox.

StackPanel and Grid – Alignments and Name cleared  (note: when the StackPanel is created inside a GroupBox or Expander, the tag modifications are ignored and overridden by the designer.)

TextBox, TextBlock, Label, CheckBox, RadioButton – smaller sizes than the Visual Studio defaults and Named is cleared.  The smaller sizes widths were 120, now 80, except TextBox which is 100.  You can play around with control creation to see if this makes sense for you.

Modify Control Tags and Chainsaw Clears Name

If you want control names cleared by the Chainsaw or the control Modify Control Tags on Create feature check this menu option.  To turn off name clearing, uncheck this menu option.

Video

PLEASE view this short tutorial video.  You will get a full and quick understanding of this great feature.

This video is on my SkyDrive.  Silverlight Streaming is being discontinued and won’t let me upload any more video files.  Like many others, I’m trying to find an alternate location to host all my training videos.  Relocating and re-pointing all my videos will be a huge PIA.  Any suggestions for hosting would be greatly appreciated.

The below video can be downloaded and viewed.  Click the link to be taken to my SkyDrive.

  XAML Power Toys 2010 Beta2 for Cider Tutorial Video (13 minutes)

Downloads – Visual Studio 2010 Beta2 ONLY

This software will not work in the final release of Visual Studio 2010.  That includes RC/RTM releases.  I will release a new version when RC (release candidates) are published.

Remember – Please build your projects before attempting to create forms, ViewModels or using the Field List.

Please set your Control Defaults after installing, new options have been added.

Download now comes from my Windows Live Sky Drive.

Microsoft employees please read this:

If you are using the final Beta2 release these links and this software will work for you.

If not please  email me and I’ll send you an internal drop location you can get this software from.  (Just look me up in the Global address book.)

XAML Power Toys 2010 for Cider – for Visual Studio 2010 Beta2 v1.0.1 Release (459 KB)

XAML Power Toys 2010 for Cider – for Visual Studio 2010 Beta2 v1.0.1 Source Code not required (85 KB)

Alternate Download Site

Some corporate firewalls do not allow access to Windows Live Sky Drive.  You can download the installer here.  Remember to rename the file from .doc to .zip.  This is a requirement of WordPress.

XAML Power Toys 2010 for Cider – for Visual Studio 2010 Beta2 v1.0.1 Release (459 KB)

Your Feedback

I can’t not over emphasize the the importance and the weight of your feedback on this block post.  My team (Cider Team that delivers the WPF & Silverlight Designer) is eager to hear from customers on features you need in the WPF & Silverlight Designer and XAML Editor.

Close

Hope you use and enjoy XAML Power Toys for Visual Studio 2010 Beta2 for Cider.

Have a great day,

Just a grain of sand on the worlds beaches.

This post is the home page for XAML Power Toys for Visual Studio 2010 Beta2.  Please post all comments and suggestions for this version on this post.

XAML Power Toys for Visual Studio 2010 has all the same features as XAML Power Toys for Visual Studio 2008 except as noted below.  Please use the XAML Power Toys for Visual Studio 2008 page as a reference for how the the features work.  Please download this version of the software below.

During development of XAML Power Toys for Beta2 I ran into some bugs that are being corrected for the final release of Visual Studio 2010.  As a result I had to cut a few features for this release.

The below image displays the menu for XAML Power Toys for Visual Studio 2010 Beta2.  Users of the 2008 version will notice the “Group Into” submenu is gone; the “Tools” submenu is gone and that “Create ViewModel for Class” is displayed in the this submenu but it shouldn’t.

The bottom line is, submenus are broken in Beta2 and there is no known workaround.

Notice I have moved “Set Control Defaults” and “About” features from the “Tools” submenu to this submenu.

The other grayed out menu options are not enabled because no XAML was selected when the screen shot was taken.  All features on this menu work as advertised.  “Create ViewModel for Class” just displays here in error and will never be enabled.  It does work correctly in the C# and VB.NET Code Windows.

The good news is, the above software has been updated and works great in Visual Studio 2010 Beta2.

When the final release of Visual Studio 2010 is public I will release a new version without these limitations.

Downloads – Visual Studio 2010 Beta2 ONLY

Remember – Please build your projects before attempting to create forms, ViewModels or using the Field List.

Please set your Control Defaults after installing, new options have been added.

Download now comes from my Windows Live Sky Drive.

Download XAML Power Toys for Visual Studio 2010 Beta2 v5.1.0001 Release Installer (809 KB)

Download XAML Power Toys for Visual Studio 2010 Beta2 v5.1.0001 Source Code not required (594 KB)

Alternate Download Site

Some corporate firewalls do not allow access to Windows Live Sky Drive.  You can download the installer here.  Remember to rename the file from .doc to .zip.  This is a requirement of WordPress.

Download XAML Power Toys for Visual Studio 2010 Beta2 v5.1.0001 Release Installer (809 KB)

Visual Studio 2010 Beta2 Known Issues

The below issues are known, being worked on and will be fixed for the RC/RTM milestone.

1.  Can’t Add Menu inside an AddIn

This problem was first reported on MS Connect. 

https://connect.microsoft.com/VisualStudio/feedback/ViewFeedback.aspx?FeedbackID=462766&wa=wsignin1.0

The workaround for this bug is to set the “Embod Interop Types” property to False for the “Microsoft.VisualStudio.CommandBars 8.0 Reference”

2.  Submenus keep repeating

When adding a submenu to a menu you have added in an AddIn, the submenus will repeat the entire menu tree instead of just showing the submenu items.

This is why I had to remove the “Group Into” submenu and features.  The submenus were simply unusable.

3.  Setup project “Client Framework” problems

When I first compiled the Setup project for this release, upon installation I kept getting a message that I had to install the .NET 4.0 Framework.  Obviously the full .NET framework was installed on the machine.

The only way I could get the message to not show up when running the Setup.exe, was to remove all references to the “Client Framework” within the solution.

Remember, in Visual Studio 2010 Beta2 all WPF and Class Library projects will by default target the “.NET 4.0 Client Framework.”  This is a good thing as it makes application distribution and installation easier for customers of your applications.

However, in this Beta2 release, to get the files to install from the output of the Setup project I had to remove all references to the “Client Framework.”

Close

Hope you use and enjoy XAML Power Toys for Visual Studio 2010 Beta2.

Have a great day,

Just a grain of sand on the worlds beaches.

At the request of a XAML Power Toys user I have updated XAML Power Toys for Visual Studio 2008 to version v5.0.0.01.

This update adds one new feature and corrects the v5 known issue.

The ViewModel creation window now allows selecting the name of the method that is used to raise the  PropertyChanged event.  You can thank Ted Warring for the suggestion.  Awesome Ted, appreciate the feedback and feature suggestion.

ViewModel Creator Gets New Feature

The ViewModel creator tool makes building a ViewModel class a snap.  This feature is sensitive to C# and VB.NET and will create the correct code for you.

The yellow highlight indicates the new feature added in v5.0.0.1.  You can now select or type in the name of the method that will be called when raising a PropertyChanged event.

This name value is also used if you selected the Implement INotifyPropertyChanged option.

This name feature enables you to use any name in your ViewModel base classes and have the generated code us it.

As always, you can download XAML Power Toys for Visual Studio 2008 here:

http://karlshifflett.wordpress.com/xaml-power-toys/

Close

Hope you use and enjoy XAML Power Toys for Visual Studio 2008.

Have a great day,

Just a grain of sand on the worlds beaches.

In .NET 4.0 WPF text rendering has been greatly improved.

However this new feature is not enabled by default.

You can read the complete feature write up on the WPF Text Blog.

The scenario where you get the most payback for using this feature is with text that is sized 15pt and below.

Line of Business forms containing TextBlocks, Labels, CheckBoxes, RadioButtons, Buttons and TextBoxes will have FontSizes below 15pt and will receive the most benefit of this new feature.

The feature is enabled by placing the “TextOptions.TextFormattingMode” attached property on the UI Element or on a parent UI Element.

<TextBlock Text=".NET 3.5 rendering" />

<TextBlock Text=".NET 4.0 improved rendering" TextOptions.TextFormattingMode="Display" />

The below XAML demonstrates how to have all text rendering use the new text rendering feature by placing the “TextOptions.TextFormattingMode” attached property on the Window.

In the below example, all child controls of the Window will use the new text rendering.

<Window x:Class="MainWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    Title="MainWindow" Height="350" Width="525"
    TextOptions.TextFormattingMode="Display">
    <Grid>

        <TextBlock Text="Inherited the .NET 4.0 improved rendering" />

    </Grid>
</Window>

Visual Studio 2010 Beta2 and .NET 4.0 have a lot of new goodness, go check it out!

Have a great day,

Just a grain of sand on the worlds beaches.

Silverlight 3 application demonstrating Sample Data.

Displaying Sample Data in the WPF and Silverlight Designer for Visual Studio 2010 Beta2 is now very easy with the design time DesignData markup extension.

The below video is a complete tutorial for using Sample Data in your WPF and Silverlight applications.  Please take a view few minutes to view it.

The Sample Application templates have many comments in them, walking you through Sample Data.  Please take a few minutes and review the projects created by the Sample Application Templates.

Beta2 Template Information

For Beta2, you need to use these templates to consume sample data in your projects.  The reason is the winfx.targets file for was not updated with the Sample Data Build Actions in time for Beta2.

These project files have been modified to include the DesignData Build Action for the Sample Data files.  All Sample Data files must have their Build Action set to DesignData in the properties window.

These templates will not be required for the final version of Visual Studio 2010.

There are really two templates.

1.  <Language> <Platform> Empty Application – this template consists of an empty project file and the added Build Action DesignData.

2.  <Language> <Platform> Sample Application – this template consists of a sample application that has sample data files and a UserControl that demonstrates how to consume the sample data.  It also includes the added Build Action DesignData.

WPF Templates

VB WPF Application DesignData – Empty VB.NET WPF Application template with sample data support.

VB WPF Application DesignData Sample – VB.NET Sample WPF Application that demonstrates consuming sample data.

CS WPF Application DesignData – Empty C# WPF Application template with sample data support.

CS WPF Application DesignData Sample – C# Sample WPF Application that demonstrates consuming sample data.

Silverlight Templates

VB SL Application DesignData – Empty VB.NET SL Application template with sample data support.

VB SL Application DesignData Sample – VB.NET Sample SL Application that demonstrates consuming sample data.

CS SL Application DesignData – Empty C# SL Application template with sample data support.

CS SL Application DesignData Sample – C# Sample SL Application that demonstrates consuming sample data.

Sample Application Template Usage

The WPF and Silverlight sample application template creates an application complete with sample data files, entity classes, a UserControl consuming the sample data files and

xmlns:d – How To Easily Add The d: Namespace

All design time properties live in a design time namespace that is part of this schema: http://schemas.microsoft.com/expression/blend/2008.

Examples of design time properties are, d:DesignWidth, d:DesignHeight, d:DesignInstance, d:DesignData, d:DataContext, d:Source.

In order to use the d: properties you must have a xmlns declaration in your XAML.  In Visual Studio 2010 there is a very easy way to add it to a Window, UserControl or Page .xmal file.

If you select the root control, you’ll see a Root Size Mode button displayed in the lower right hand corner.  Clicking this button changes the size mode of your root container from Auto to Fixed or from Fixed to Auto.

If the d: namespace has not been added to the root control yet, clicking this button will do it for you.  In addition to the d: namespace, mc: is added and the mc:Ignorable is added also.

I have modified each of the starter templates below to automatically add this for you.  However, as you add new Windows, Pages or UserControls, those templates may not have the d: namespace declarations, so the above trick comes in handy.

Adding a New Sample Data File

Open an existing Sample Data project or Create a new project using one of the Sample Data templates.

Add a resource dictionary to the project naming it <my entity class name>SampleData.xaml.

For example:  Customer sample data file would be named, “CustomerSampleData.xaml”

The the file properties as pictured below:

Build Action: DesignData

Copy to Output Directory: Do not copy

Custom Too:  <blank>

Editing a New Sample Data File

This is an example of a single instance sample data file.

<local:Customer
    xmlns:local="clr-namespace:WPFApplication2"
    Age="21" Email="jim@hotmail.com"
    FirstName="Jim" LastName="Smith" />

Sample Data files allow you to construct your objects in XAML.  You can set the required properties as illustrated above.

The below code illustrates how to create a collection of items in a sample data file.

<local:Customers xmlns:local="clr-namespace:WPFApplication2">
    <local:Customer
        Age="21" Email="jim@hotmail.com"
        FirstName="Jim" LastName="Smith" />
    <local:Customer
        Age="22" Email="jane@hotmail.com"
        FirstName="Jane" LastName="Smith" />
</local:Customers>

The above Customers class derives from the Generic List of Customer.

Consuming Sample Data in WPF

<!-- DataGrid Sample-->
<Grid d:DataContext="{d:DesignData Source=/SampleData/PeopleSampleData.xaml}"
      Grid.Row="1" Margin="7">
    <DataGrid ItemsSource="{Binding}"/>
</Grid>

Sample Data is exposed through the d:DataContext design time property.  Design time properties are not compiled into your applications.

In WPF this is how you start at the root, navigate to SampleData folder and get the xaml file.

Consuming Sample Data in Silverlight

<!-- DataGrid Sample-->
<Grid d:DataContext="{d:DesignData Source=../SampleData/PeopleCollectionSampleData.xaml}"
      Grid.Row="1" Margin="7">
    <data:DataGrid ItemsSource="{Binding}"/>
</Grid>

In Silverlight you have to ../ up to the root, then navigate to SampleData folder and get the xaml file.

Slight difference between WPF and Silverlight.

Video

PLEASE view this short tutorial video.  You will get a full and quick understanding of this great feature.

This video link supports right click, save as…

  Sample Data Tutorial Video (22 minutes)

Installing Templates Using The Download

For VB.NET copy the download to:

C:\users\<your user name>\Documents\Visual Studio 2010\Templates\ProjectTemplates\Visual Basic

Unzip the download in this folder.  You should have 4 zip files in the folder.  You are ready to go.

For C# copy the download to:

C:\users\<your user name>\Documents\Visual Studio 2010\Templates\ProjectTemplates\Visual C#

Unzip the download in this folder.  You should have 4 zip files in the folder.  You are ready to go.

Downloads

After downloading one or both template downloads, you’ll need to rename the file extension from .doc to .zip.  This is a requirement of WordPress.com.

Requires:  Visual Studio 2010 Beta2

Silverlight Templates require:  Silverlight 3

VB.NET Project Templates (61KB) (updated 10-28-2009)

C# Project Templates (58KB) (updated 10-28-2009)

Installing Templates From Within Visual Studio 2010 Beta2

The sample data templates are also be individually available on the Visual Studio Code Gallery.

To use a single template open the New Project Dialog and select the Online Templates tab at the bottom left.  You can browse all available templates or search for “design” and all the templates will be listed.

Close

Hope you use and enjoy Sample Data in Visual Studio 2010 Beta2.

Gentle reminder, please watch the above video too.

Have a great day,

Just a grain of sand on the worlds beaches.

For the past few months I’ve been sharpening my Windows 7 skills and discovered what many systems people already know; “you can easily setup and boot Windows 7 or Server 2008 R2 VHD.”

Someone may already be thinking, why do I need to boot a VHD?

It’s no secret that Microsoft will be shipping Visual Studio 2010 Beta2.  If you want to be notified when Beta2 ships you can sign up here:  http://www.microsoft.com/visualstudio/en-us/products/2010/default.mspx

Some developers prefer to install beta software on a non-production machine or set up a multi-boot box.

This is where VHD’s come into play.  You can setup a VHD on your desktop or laptop, then from the boot menu, select to boot that VHD or boot the operating system.  I’ve been doing this at home and work for awhile now and love it.

VHD’s also enable you to have a x32 O/S boot and a x64 O/S boot on the same machine.   Possibilities are endless.

When you’re done with the VHD, just delete it and make a new one.

VHD’s sport great performance.  If you use the fixed size VHD, the total performance cost is 3%.  When I boot a VHD on my laptop I don’t see any drop in performance from booting the original O/S.

VHD’s do not require Hyper-V to boot them.  Server 2008 R2 does have a Hyper-V feature that allows you to log onto a VHD.  But what I’m explaining here does not require Hyper-V.  This is why I love this feature, it just works.

Recommendations

Before creating a new VHD, defrag the volume you want to add the VHD to.

I always create a fixed size VHD to ensure maximum performance.  Dynamic sized VHD’s offer flexibility with respect to size but pay a performance hit.

I’ve been allocating 45GB for all my VHDs.  This leaves plenty of room for Windows 7, Visual Studio, Microsoft Office and other applications and data on the VHD.  After you have created and configured a few of these, you’ll determine what works best for you.

I created a c:\vhd folder and locate all my VHD files here.

Possible Configuration Scenarios

Computer has Windows 7 or Server 2008 R2 installed and one or more Windows 7 or Server 2008 R2 VHD’s.

Computer does not have any O/S installed, but has one or more VHD’s that can be booted.  How cool is this?

Possible VHD Installation Options

Create a new VHD and install Windows 7 from a DVD or network location.

Create a new VHD and use imagex.exe to restore a .wim file to the VHD.  This is my favorite.  This saves so much time.  You install an O/S, configure it and install all the other software you need (except Visual Studio).  Then use imagex.exe to save a copy of the O/S and software to a .wim file.  You can then use imagex.exe to restore that .wim file to a VHD or if you need to a boot partition.  I do this at work every 1-2 weeks.  Takes a few minutes to pave my box.  Awesome software imagex.exe is!

On my laptop and desktop systems, I keep an extra VHD file that is all ready to go.  It’s configured and has all the software I need except Visual Studio.  Then when I want to load up another version of Visual Studio, I copy the files I need, delete the old VHD, copy the standby VHD to another new VHD, boot the new one and install Visual Studio.  Even on my laptop with the 45GB file copy and installing a new Visual Studio I’m up and running quickly.

Imagex.exe

What is imagex.exe?  Read this: http://technet.microsoft.com/en-us/library/cc507842.aspx

Where can I get imagex.exe?  Here: http://www.microsoft.com/downloads/details.aspx?familyid=696DD665-9F76-4177-A811-39C26D3B3B34&displaylang=en.  

Read how Scott Hanselman uses imagex.exe.  Great blog post!  Step-By-Step: Turning a Windows 7 DVD or ISO into a Bootable VHD Virtual Machine

Links

Rather that create a new blog post with pictures, etc, I’m going to provide the links that I’ve used to be successful with VHD’s.

Scott Hanselman: Step-By-Step: Turning a Windows 7 DVD or ISO into a Bootable VHD Virtual Machine

Microsoft TechNet: Windows 7 Boot from VHD.  This is actually the home page for a 3 part series on VHD files.  Very well written and covers the scenarios I’ve listed above. 

Microsoft Evangelist Keith Combs: 

Video:  Dual Boot from VHD with Windows 7 and Windows Sever 2008 R2
Article:  Dual Boot from VHD Using Windows 7 and Windows Server 2008 R2

Close

I hope you find this information informative and useful. 

Have a great day,

Just a grain of sand on the worlds beaches.

I contacted JB Evain the author of Mono.Cecil and determined that Mono.Cecil is licensed under the MIT X11 License and not the Creative Commons license I thought it was.  Many thanks to JB for clearing this up for me and for his Mono.Cecil work. 

I have updated the XAML Power Toys installer to reflect the new license.

If you have downloaded XAML Power Toys already, you do not need to re-download since the MIT X11 license is even less restrictive than the Creative Commons license I thought I had to use.

Sorry for any confusion, this is my first license agreement I had to post.

The new MIT X11 License now reads:

License Agreement

Copyright (c) 2009 Little Richie Software

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Have a great day,

Just a grain of sand on the worlds beaches.

If you have more than one monitor, keep reading.

When you open Sunday Night Football to view using the new Silverlight player, go full screen and then start using your other monitor to work, Silverlight immediately goes back to the smaller size.  Bummer.

It’s actually a security feature, which is good.

Workaround

1.  Open Sunday Night Football on your second monitor.

2.  Press CTRL + N.  This will open a new browser window that you can do what you want size wise.

3.  Close the original browser.

4.  Now use your browser zoom feature and zoom the screen the way you want.  The scrollbar allows you to position the screen as desired.

Have a great day,

Just a grain of sand on the worlds beaches.

It’s here and posted at: http://karlshifflett.wordpress.com/xaml-power-toys/

Please read the Known Issue, New Installation and Upgrading sections in the above page.

Five New 1280 x 1024 videos too.

New Features and Changes in v5.0

• x32 and x64 support. 
• Creation of Silverlight 3 DataForm from a selected class.
• ViewModel creation now allows optionally re-implementing Model properties on the ViewModel.
• Moved XAML Power Toys saved settings file out of the “\Program Files\Little Richie Software\XAML Power Toys” folder to “\Program Data\Little Richie Software\XAML Power Toys” folder.
• Visual Studio “Add-in\Macro Security” entry no longer required.
• Removed XAML Power Toys Solution Explorer context menus.  All features are now accessed from either a code window or the XAML Editor.
• Fixed the installer program to simply installing and uninstalling XAML Power Toys.  Version 5 no longer requires any additional steps for a clean install or uninstall.
• Completely rewrote the secondary application domain loading code from scratch.
• Verified XAML Power Toys has no side by side issues with DevExpress. 
• Added license agreement MIT X11 License.  This was done for two reasons:
  • I’m now using Mono.Cecil for assembly reflection and it’s licensed using the above license.
  • Many corporate developers have a requirement that all software they install and use must have a license agreement.  I’ve added it so corporate customers can now use XAML Power Toys in their organizations.

Have a great day,

Just a grain of sand on the worlds beaches.

My blog has been very quiet the last month because I’ve been working very long hours in preparation for the next release of Visual Studio 2010.  On the weekends I was relaxing and not doing much with my computer.

I’ve been all cranked up at home the last week, back to my 2:00am working sessions.

I’m sitting at FireStarter in Redmond now and will be presenting XAML Power Toys v5 at 3:45pm PST. 

You can watch FireStarter live, right now at: 

http://mindseyepdx.com/microsoft/firestarter/test/index2.html

I’ve added every feature that was requested on my blog and email.  This includes but is not limited to:

• Support for Silverlight DataForm Control
• DataForm creation from RIA Services data model
• x64 support
• ViewModel creation, re-implement one or more model properties on the ViewModel
• Completely rewritten assembly loading code, no more load failures!
• Full compatibility with DevExpress tools. 
• Settings file moved out of Program Files folder to the APPDATA folder.

I have tested the new version with complex multi-project solutions and it is sweet.

Have a great day,

Just a grain of sand on the worlds beaches.

My great friend Rob Zelt and President of INETA emailed me about their coding contest that has fantastic prizes for the top 10 winners.  1st and 2nd place get full scholarship to PDC 2009.

Full details can be read here: http://www.ineta.org/codechallenge/

Submission deadline is 8/25/2009.

FYI: contest focus is on building applications with 3rd party controls.  You are allowed to write you application using the demo version of the vendor’s controls.

Go for it!

Have a great day,

Just a grain of sand on the worlds beaches.

On 17 September you have a wonderful and free opportunity to kick-start your Silverlight and Blend 3 skills. 

I’ve started writing Silverlight 3 applications and love where this platform currently is and where it’s heading.

Come join us in Redmond or watch online this exciting day of practical learning that you can apply immediately.

Event Overview (copied from the registration page)

This summer’s biggest blockbuster technology event is coming to Redmond, WA on the 17th of September.

Register to attend the Silverlight-3 FireStarter event on Thursday, the 17th of September.

We have a stellar speaker line up from the Microsoft roster. We will have Scott Guthrie keynote the event followed by presentations from Tim Heuer, Brad Abrams, Karl Shifflett and others.

At this event we will focus on three areas:

• What’s latest and greatest in with the latest release of Silverlight
• What’s happening in the world of Expression 3
• Give you a run down on .NET RIA Services, Toolkit, etc.

Registration

Register to attend in person (Microsoft Campus Redmond, WA).

Register to attend online.

Schedule

Have a great day,

Just a grain of sand on the worlds beaches.