Click here to Skip to main content
Click here to Skip to main content

Creating and Consuming Your First WCF Service

By , 25 Sep 2009
Rate this:
Please Sign up or sign in to vote.


In this article, I will examine how to create and consume a WCF service. WCF is a next-generation programming platform and runtime system for building, configuring and deploying service-oriented applications. For more details, please see here.

Creating a WCF Service

I will create a stock service to demonstrate a WCF service. To create a WCF service, please follow these steps:

  1. Launch Visual Studio 2008.
  2. Click on File -> new -> project, then select WCF service application.
  3. It will create a WCF service application template.

I will delete the default contract and then create an IStock contract as shown below.

Using the Code

    public interface IStock
        Stock GetStock(string Symbol);   

The above contract has one method that returns a stock object for a given symbol. Here is our Stock class that has Symbol, Date, Company and Close properties respectively.

    public class Stock
        public string Symbol { get; set; }
        public DateTime Date { get; set; }
        public string Company { get; set; }
        public decimal Close { get; set; }

Next, I will delete the default service and create a Stock service that will implement the Istock contract as shown below:

 public class Stocks : IStock
        #region IStock Members
        public Stock GetStock(string Symbol)
            Stock st = null;
            switch (Symbol.ToUpper())
                case "GOOG":
                    st = new Stock { Symbol = Symbol, Date = DateTime.Now, 
			Company = "Google Inc.", Close = 495 };
                case "MSFT":
                    st = new Stock { Symbol = Symbol, Date = DateTime.Now, 
			Company = "Microsoft Corporation", Close = 25 };
                case "YHOO":
                    st = new Stock { Symbol = Symbol, Date = DateTime.Now, 
			Company = "Yahoo! Inc.", Close = 17 };
                case "AMZN":
                    st = new Stock { Symbol = Symbol, Date = DateTime.Now, 
			Company = ", Inc.", Close = 92 };
            return st;

In the above service, I implemented IStock contract that has a GetStock method which returns stock object for a given Symbol.

Now, I will have the following endpoints in my web.config:

<service behaviorConfiguration="WcfSample.Service1Behavior" name="WcfSample.Stocks">
<endpoint address="" binding="wsHttpBinding" contract="WcfSample.IStock">
 <dns value="localhost"/>
<endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"/>

In the above configuration, we have address="" which is localhost, binding="wsHttpBinding" and contract="WcfSample.IStock".

Now I will compile the service and build a client to consume the service.

Creating a Client to Consume Service

To create a client, I will create a web application. Please follow these steps.

  1. Right Click on Solution -> Add -> new project, then select ASP.NET web application.
  2. It will create a web application template.
  3. Now, I will add the service reference. To add a service reference, select client application, then add a service reference. Since our client is in a same solution, I will click discover and service in the solution as shown below:

  4. In default.aspx, I will create a simple UI, a textbox to enter the stock symbol and a button to call the service to get stock information. Here is our code behind:

    ServiceReference2.StockClient sc = new ServiceReference2.StockClient();
    ServiceReference2.Stock st = sc.GetStock(TextBox1.Text.Trim());
    StringBuilder sb = new StringBuilder();
    sb.AppendFormat("<B>Company:</B> {0}<br />", st.Company);
    sb.AppendFormat("<B>Date: </B>{0}<br />", st.Date);
    sb.AppendFormat("<B>Close: </B>{0}<br />", st.Close);
    sb.AppendFormat("<B>Symbol: </B>{0}<br />", st.Symbol); 
    Label1.Text = sb.ToString(); 
  5. Here are a few screenshots from our final application:


In this article, we examined how to create and consume a WCF service. As you can see, creating and consuming WCF service with Visual studio 2008 is pretty simple.


  • 25th September, 2009: Initial post


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

About the Author

Farooq Kaiser
Software Developer (Senior)
Canada Canada
12+ years of complete software development life cycle experience for web based applications and multi-tier client-server desktop, primarily using LINQ, WCF, WWF, C#, ASP.NET, XML, XSLT, AJAX, Winforms,Visual Basic, JavaScript, JQuery, Google APIs, C++, VB.NET, C, ATL/COM, Open XML. Extensively involved in the requirement analysis, feasibility study, conceptualization, planning, architecture/design, configuration, development, quality assurance, implementation and release of the software products.

Comments and Discussions

GeneralMy Vote of 4 PinmemberJared Beach13-Feb-14 2:15 
GeneralMy Vote is 3 PinmemberAshish Ramteke10-Feb-14 0:49 
Questioncomment for code Pinmembermanjiri 20127-Jan-14 23:07 
QuestionGot an error PinmemberDiegoSalvatore26-Nov-13 8:30 
Questionuse xamarin android Pinmemberbeyazcennet4-Nov-13 12:50 
GeneralEasiest way to create and consume WCF Services in PinmemberLalit24rocks14-May-13 21:14 
QuestionEasiest way to create and consume WCF Services in ? PinmemberLalit24rocks14-May-13 21:00 
GeneralMy vote of 2 PinmemberMember 980908511-Mar-13 21:21 
QuestionMy Vote 4 Pinmembermadhan430-Jan-13 6:21 
GeneralMy vote of 5 PinmemberWeerayut Teja11-Jan-13 16:39 
GeneralMy vote of 4 Pinmemberkaramusti22-Nov-12 21:13 
GeneralMy vote of 5 Pinmemberkishormahale7-Nov-12 23:37 
GeneralMy vote of 5 PinmemberAmol Borkar, Pune, India9-Oct-12 23:20 
GeneralMy vote of 3 PinmemberAnirudha_baba16-Aug-12 20:46 
GeneralMy vote of 5 PinmemberChristian Amado10-Aug-12 7:42 
Questionthankq Pinmemberjareenkumar27-Jul-12 0:48 
SuggestionMy Vote 4 -How Host WCF service on IIS and Consume it From WPF PinmemberShailesh vora8-Jul-12 20:06 
GeneralRe: My Vote 4 -How Host WCF service on IIS and Consume it From WPF PinmemberFaizan Mubashar25-Dec-13 22:17 
GeneralMy vote of 4 PinmemberShailesh vora8-Jul-12 20:04 
Great Article For the Beginner.
Please write one article which shows that how to host the same service on IIS.
GeneralMy vote of 4 Pinmemberashriv4-Jun-12 19:14 Pinmembernongkhanhk5b25-Mar-12 23:38 
GeneralMy vote of 2 Pinmembercuneyd7611-Nov-11 5:36 
GeneralGood Article Pinmembershakkeer22-Sep-11 23:04 
QuestionNice clean article - PinmemberHaBiX3-Aug-11 23:51 
GeneralPerfect for beginner PinmemberDz0n Walker13-Jul-11 4:50 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web04 | 2.8.140415.2 | Last Updated 25 Sep 2009
Article Copyright 2009 by Farooq Kaiser
Everything else Copyright © CodeProject, 1999-2014
Terms of Use
Layout: fixed | fluid