Sep 10

Written by: Michael Washington
9/10/2011 6:29 AM 

When you write code in the LightSwitch client layer, you have programmatic access to most of the application. This also applies when you use Silverlight Custom Controls. This is important because it saves you from writing a lot of code. A professional developer can be far more productive when creating a LightSwitch application than when they are coding a Silverlight application without using LightSwitch.

You have the option of Running a LightSwitch Application With A Blank Shell. When you do that, you still have access to all the features described in this article.

In this article, we will take a random walk though the LightSwitch API (Application Programming Interface) to give you an idea of the programmatic access available to you from a  LightSwitch Silverlight Custom Control (this also applies to LightSwitch Control Extensions).

 

This page describes the LightSwitch Data Model: http://msdn.microsoft.com/en-us/library/gg445195.aspx. There are a lot of classes covered, and the diagram is a very broad overview. However, it does describe the relationship between the major parts.

Note: You must have Visual Studio Professional (or higher) to create Silverlight Control using the method described in this article.

 

The LightSwitch Explorer Application

We will take our random walk through the LightSwitch API by creating a sample LightSwitch application. We will create a Silverlight Custom Control called “LightSwitch Explorer” that will display information about the collections of the screen that it is displayed on, raise methods, and switch screens.

 

We create a simple LightSwitch application that allows Products and Orders to be managed.

 

One screen for Products.

 

One screen for Orders.

 

The Silverlight Control

Add a new project to the Solution.

 

 

We add a Silverlight Class Library,

 

We select Silverlight 4.

 

The Project will show in the Solution Explorer, we right-click on the Class1.cs file and Delete it.

 

We add a New Item to the SilverlightControlLibrary project.

 

We add a Silverlight User Control, and call it LightSwitchExplorer.xaml.

 

We Right-click on References, and select Add Reference.

 

We add references to:

• Microsoft.LightSwitch
• Microsoft.LightSwitch.Base.Client
• Microsoft.LightSwitch.Client

This will allow access the LightSwitch API in the code behind file in the LightSwitchExplorer.xaml control.

 

We open the LightSwitchExplorer.xaml.cs file, and add the following using statements:

• using Microsoft.LightSwitch;
• using Microsoft.LightSwitch.Client;
• using Microsoft.LightSwitch.Details;
• using Microsoft.LightSwitch.Details.Client;
• using Microsoft.LightSwitch.Model;
• using Microsoft.LightSwitch.Presentation;
• using System.Windows.Data;
• using System.Collections;

 

 

We open the LightSwitchExplorer.xaml file, and change the markup to the following:

 

<UserControl x:Class="SilverlightControlLibrary.LightSwitchExplorer"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="d"
    d:DesignHeight="300" d:DesignWidth="400">
    <Grid x:Name="LayoutRoot" Background="White">
        <Grid.ColumnDefinitions>
            <ColumnDefinition Width="122*" />
            <ColumnDefinition Width="122*" />
            <ColumnDefinition Width="122*" />
        </Grid.ColumnDefinitions>
        <Grid.RowDefinitions>
            <RowDefinition Height="20*" />
            <RowDefinition Height="100*" />
            <RowDefinition Height="177*" />
        </Grid.RowDefinitions>
        <ListBox HorizontalAlignment="Stretch" VerticalAlignment="Stretch" Margin="5,5,5,5"                   
                 Name="lstMethods" Grid.Row="1" Grid.Column="1"  />
        <ListBox HorizontalAlignment="Stretch" VerticalAlignment="Stretch" Margin="5,5,5,5"
                 Name="lstActiveScreens" Grid.Row="1"  />
        <ListBox HorizontalAlignment="Stretch" VerticalAlignment="Stretch" Margin="4,5,5,5"                  
                 Name="lstApplicationDetailsProperties" Grid.Column="2" Grid.Row="1"  />
   </Grid>
</UserControl>

 

This just adds a grid and three ListBoxes.

 

We drag and drop a DataGrid on the page.

This will automatically add the needed assemblies to support the DataGrid.

 

We click and drag the corners of the grid to size it so it fill the entire bottom half of the page.

 

In the Properties for the DataGrid, we check the box next to AutoGenerateColumns.

 

We drag and drop a Label above the first box and change its Content to “Active Screens”.

 

We add two more Labels and name them “Methods” and “Collections”.

 

Add Code To The Silverlight Control

Open the LightSwitchExplorer.xaml.cs file, and add the following code:

 

        // This property is created because it allows us to raise 
        // "OnExplorerControlDataContextPropertyChanged"
        // When the DataContext is updated
        public static readonly DependencyProperty ExplorerControlDataContextProperty =
            DependencyProperty.Register("DummyProperty", typeof(IContentItem), 
            typeof(LightSwitchExplorer),
            new PropertyMetadata(OnExplorerControlDataContextPropertyChanged));

 

Next, add this line after the InitializeComponent(); line:

this.SetBinding(ExplorerControlDataContextProperty, new Binding());

This sets the binding for the ExplorerControlDataContextProperty.

 

Add the following methods:

 

        #region ShowMethodsOnScreen
        private static void ShowMethodsOnScreen(LightSwitchExplorer EC, IContentItem contentItem)
        {
            // Fill the lstMethods ListBox with a list of all Methods on the current Screen
            foreach (var item in contentItem.Screen.Details.Commands.All())
            {
                EC.lstMethods.Items.Add(item.Name);
            }
        }
        #endregion
        #region ShowActiveScreens
        private static void ShowActiveScreens(LightSwitchExplorer EC, IContentItem contentItem)
        {
            // Fill the lstActiveScreens ListBox with a list of all Active Screens
            foreach (var item in contentItem.Screen.Details.Application.ActiveScreens)
            {
                EC.lstActiveScreens.Items.Add(item.Screen.Name);
            }
        }
        #endregion
        #region ShowScreenCollections
        private static void ShowScreenCollections(LightSwitchExplorer EC, IContentItem contentItem)
        {
            // Fill the lstApplicationDetailsProperties ListBox with a list of all 
            // Collections on the current Screen
            foreach (var item in contentItem.Screen.Details.Properties.All())
            {
                EC.lstApplicationDetailsProperties.Items.Add(String.Format("{0}", item.Name));
            }
        }
        #endregion

 

Finally add the following method that will raise the previous methods when the DataContext is set or changed:

 

        private static void OnExplorerControlDataContextPropertyChanged(
            DependencyObject d, DependencyPropertyChangedEventArgs e)
        {
            LightSwitchExplorer EC = (LightSwitchExplorer)d;
            IContentItem contentItem = (IContentItem)EC.DataContext;
            ShowActiveScreens(EC, contentItem);
            ShowMethodsOnScreen(EC, contentItem);
            ShowScreenCollections(EC, contentItem);
        }

 

Insert The Silverlight Control Into The Application

Build the Solution.

 

Open the EditableProductsGrid screen, and add a New Custom Control.

 

Click the Add Reference Button.

 

Create a Project reference to the SilverlightControlLibrary project.

 

We will now be able to select the Custom Control we created.

 

In the Properties for the control, set the Label Position to None.

 

When we run the application, we see that the control displays the Active Screens, the Methods on the current Screen, and the Collections on the current Screen.

 

Make The Explorer Control Interactive

Return to the Silverlight Control, and double-click on the Active Screens ListBox.

 

The Method will be wired-up.

 

Use the following code for the Method:

 

        private void lstActiveScreens_SelectionChanged(object sender, SelectionChangedEventArgs e)
        {
            // Get the LightSwitch DataContext
            IContentItem contentItem = (IContentItem)this.DataContext;
            // The selected screen
            string strScreenName = (sender as ListBox).SelectedValue.ToString();
            // Get the selected Screen
            var SelectedScreen = (from ActiveScreens in 
                                      contentItem.Screen.Details.Application.ActiveScreens.AsQueryable()
                                  where ActiveScreens.Screen.Name == strScreenName
                                  select ActiveScreens).FirstOrDefault();
            if (SelectedScreen != null)
            {
                // Activate the selected Screen
                SelectedScreen.Activate();
            }
        }

 

Double-click on the Methods ListBox.

 

Use the following code for the Method:

 

        private void lstMethods_SelectionChanged(object sender, SelectionChangedEventArgs e)
        {
            // Get the LightSwitch DataContext
            IContentItem contentItem = (IContentItem)this.DataContext;
            // The selected Method
            string strMethodName = (sender as ListBox).SelectedValue.ToString();
            var Method = (from Commands in contentItem.Screen.Details.Commands.All()
                          where Commands.Name == strMethodName
                          select Commands).FirstOrDefault();
            if (Method != null)
            {
                // Get a reference to the LightSwitch Screen
                var Screen =
                (Microsoft.LightSwitch.Client.IScreenObject)contentItem.Screen;
                Screen.Details.Dispatcher.BeginInvoke(() =>
                {
                    Method.Execute();
                });
            }
        }

 

 

Double-click on the Collections ListBox.

 

Use the following code for the Method:

 

        private void lstApplicationDetailsProperties_SelectionChanged(object sender, SelectionChangedEventArgs e)
        {
            // Get the LightSwitch DataContext
            IContentItem contentItem = (IContentItem)this.DataContext;
            // The Property Name
            string strPropertyName = (sender as ListBox).SelectedValue.ToString();
            var Property = (from Properties in contentItem.Screen.Details.Properties.All()
                            where Properties.Name == strPropertyName
                            select Properties).FirstOrDefault();
            dataGrid1.ItemsSource = (IEnumerable)Property.Value;
        }

 

The Explorer Control

Add the Explorer Control to the other pages of the application.

• You can click on the Active Screens to switch screens
• You can click on the Methods to execute them
• You can click on the Collections to see their contents (and edit them)

 

This Is Barely Scratching The Surface

This example barely touches upon all that is available to the LightSwitch developer. Information about the user, the complete database schema and data, and the entire application is available.

Operations that would normally take hundreds of lines of code to manually create in a Silverlight application, can be achieved with half a dozen when using LightSwitch.

 

Special Thanks

A special thanks to Sheel Shah because otherwise this article would not be possible.

 

Download Code

The LightSwitch project is available at http://lightswitchhelpwebsite.com/Downloads.aspx

 

Further Reading

Working with Data-Related Objects in Code

Performing Data-Related Tasks by Using Code

Running a LightSwitch Application With A Blank Shell