7 Simple Steps to Connect SQL Server Using WCF from SilverLight

Introduction and Goal

In this article we will look how we can do database operations using SilverLight. We will first try to understand why we cannot call ADO.NET directly from a silverlight application and then we will browse through 7 steps which we need to follow to do database operation from silverlight.

Other Silverlight FAQ's

Silverlight FAQ Part 1:- 21FAQ's  This tutorial has 21 basic FAQ's which will help you understand WPF , XAML , help your build your first silverlight application and also explains the overall silverlight architecture.

SilverLight FAQ Part 2 (Animations and Transformations):SilverLightFAQPart2.aspx This tutorial has 10 FAQ questions which starts with silverlight animation fundamentals and then shows a simple animated rectangle. The article then moves ahead and talks about 4 different ways of transforming the objects

Silverlight does not have ADO.NET

Below are the different ingredients which constitute SilverLight plugin.  One of the important points to be noted is that it does not consist of ADO.NET. In other words you can not directly call ADO.NET code from SilverLight application. Now the other point to be noted is that it has the WCF component. In other words you can call a WCF service.

 1.JPG

In other words you can create a WCF service which does database operations and silverlight application will make calls to the same. One more important point to be noted is do not return ADO.NET objects like dataset etc because  SilverLight will not be able to understand the same.

 2.jpg
Below are 7 important steps which we need to follow to consume a database WCF service in silverlight.

Step 1:- Create the Service and Data service contract

Below is a simple customer table which has 3 fields 'CustomerId' which is an identity column, 'CustomerCode' which holds the customer code and 'CustomerName' which has the name of the customer. We will fire a simple select query using WCF and then display the data on the SilverLight grid.

Field

Datatype

CustomerId

int

CustomerCode

nvarchar(50)

CustomerName

nvarchar(50)

As per the customer table specified above we need to first define the WCF data contract. Below is the customer WCF data contract.
 
  [DataContract]
    public class clsCustomer
    {
        private string _strCustomer;
        private string _strCustomerCode;
        [DataMember]
        public string Customer
        {
            get
            {
                return _strCustomer;
            }
            set
            {
                _strCustomer = value;
            }
        }
        [DataMember]
        public string CustomerCode
        {
            get
            {
               
                return _strCustomerCode;
            }
            set
            {
              _strCustomerCode = value;
            }
        }
    }

We also need to define a WCF service contract which will be implemented by WCF concrete classes.

[ServiceContract]
    public interface IServiceCustomer
    {
        [OperationContract]
        clsCustomer getCustomer(int intCustomer);
    }

 Step 2:- Code the WCF service

Now that we have defined the data contract and service contract it's time to implement the service contract. We have implemented the 'getCustomer' function which will return the 'clsCustomer' datacontract. 'getCustomer' function makes a simple ADO.NET connection and retrieves the customer information using the 'Select' SQL query.

 public class ServiceCustomer : IServiceCustomer
    {
        public clsCustomer getCustomer(int intCustomer)
        {
            SqlConnection objConnection = new SqlConnection();
            DataSet ObjDataset = new DataSet();
            SqlDataAdapter objAdapater = new SqlDataAdapter();
            SqlCommand objCommand = new SqlCommand("Select * from Customer where CustomerId=" + intCustomer.ToString());             objConnection.ConnectionString = System.Configuration.ConfigurationManager.ConnectionStrings["ConnStr"].ToString();
            objConnection.Open();
            objCommand.Connection = objConnection;
            objAdapater.SelectCommand = objCommand; objAdapater.Fill(ObjDataset);
            clsCustomer objCustomer = new clsCustomer();
            objCustomer.CustomerCode = ObjDataset.Tables[0].Rows[0][0].ToString();
            objCustomer.Customer = ObjDataset.Tables[0].Rows[0][1].ToString();
            objConnection.Close();
            return objCustomer;
        }
    }
 

Step 3:- Copy the CrossDomain.xml and ClientAccessPolicy.XML file

This WCF service is going to be called from an outside domain, so we need to enable the cross domain policy in the WCF service by creating 'CrossDomain.xml' and 'ClientAccessPolicy.xml'. Below are both the code snippets. The first code snippet is for cross domain and the second for client access policy.

<?xml version="1.0"?>
<
! DOCTYPE cross-domain-policy SYSTEM "http://www.macromedia.com/xml/dtds/cross-domain-policy.dtd">
<cross-domain-policy>
    <allow-http-request-headers-from domain="*" headers="*"/>
</
cross-domain-policy> 

 <?xml version="1.0" encoding="utf-8" ?>
<
access-policy>
    <cross-domain-access>
        <policy>
            <allow-from http-request-headers="*">
                <domain uri="*"/>
            </allow-from>
            <grant-to>
                <resource include-subpaths="true" path="/"/>
            </grant-to>
        </policy>
    </cross-domain-access>
</
access-policy>

Step 4:- Change the WCF bindings to 'basicHttpBinding'

Silverlight consumes and generates proxy for only 'basicHttpBinding' , so we need to change the endpoint bindings accordingly.

<endpoint address="" binding="basicHttpBinding" contract="WCFDatabaseService.IServiceCustomer"> 

Step 5:- Add service reference

We need to consume the service reference in silverlight application using 'Add service reference' menu. So right click the silverlight project and select add service reference.

Step 6 :- Define the grid for Customer  Name and Customer Code

Now on the silverlight side we will create a 'Grid' which has two columns one for 'CustomerCode' and the other for 'CustomerName'. We have also specified the bindings using 'Binding path' in the text block.

      <Grid x:Name="LayoutRoot" Background="White">       
           
<Grid.ColumnDefinitions>           
               
<ColumnDefinition></ColumnDefinition>            
               
<ColumnDefinition></ColumnDefinition>        
           
</Grid.ColumnDefinitions>        
           
<Grid.RowDefinitions>            
               
<RowDefinition Height="20"></RowDefinition>            
               
<RowDefinition Height="20"></RowDefinition>        
           
</Grid.RowDefinitions>        
           
<TextBlock x:Name="LblCustomerCode" Grid.Column="0" Grid.Row="0" Text="Customer Code"></TextBlock>      
           
<TextBlock x:Name="TxtCustomerCode" Grid.Column="1" Grid.Row="0" Text="{Binding Path=CustomerCode}"></TextBlock>
            <TextBlock x:Name="LblCustomerName" Grid.Column="0" Grid.Row="1" Text="Customer Name"></TextBlock>        
           
<TextBlock x:Name="TxtCustomerName" Grid.Column="1" Grid.Row="1" Text="{Binding Path=Customer}"></TextBlock>
        </Grid> 

Step 7:- Bind the WCF service with the GRID

Now that our grid is created its time to bind the WCF service with the grid. So go to the behind code of the XAML file and create the WCF service object.  There are two important points to be noted when we call WCF service using from SilverLight:-

  • We need to call the WCF asynchronously, so we have called 'getCustomerAsynch'. Please note this function is created by WCF service to make asynchronous calls to the method / function.
     

  • Once the function completes its work on the WCF service it sends back the message to silverlight client.  So we need to have some kind of delegate method which can facilitate this communication. You can see we have created a 'getCustomerCompleted' method which captures the arguments and ties the results with the grid 'datacontext'.

   public partial class Page : UserControl
    {
        public Page()
        {
            InitializeComponent();
            ServiceCustomerClient obj = new ServiceCustomerClient();
            obj.getCustomerCompleted += new EventHandler<getCustomerCompletedEventArgs>(DisplayResults);
            obj.getCustomerAsync(1);
        }
        void DisplayResults(object sender, getCustomerCompletedEventArgs e)
        {
            LayoutRoot.DataContext = e.Result;
        }
    }
 
You can now run the project and see how the silverlight client consumes and displays the data.

 3.JPG
 
Source Code

You can download the source code from the top of this article.


Similar Articles