Click here to Skip to main content
15,867,568 members
Articles / Operating Systems / Windows
Article

Simple Web Service using WCF (Windows Communication Framework)

Rate me:
Please Sign up or sign in to vote.
4.89/5 (27 votes)
2 Jan 20073 min read 347.9K   7.7K   95   17
This article shows you how easy it is to set up a web service using Windows Communication Framework.

Web Service running

Introduction

This article shows you how easy it is to setup a web service using WCF (Windows Communication Framework). Using the source I've provided as a template, you can quickly create your own web services. This article does not deal with a client consuming the web service (you will have to wait until part 2).

Background

I've been playing around with WCF for a while, since the early CTP's. I found it difficult to find good samples/examples. Either they didn't work or I was either too lazy or too stupid to get them working. All I wanted was something that worked with very little effort (or understanding) on my part. I just wanted something I could install and get running!!!

Of course at some point everyone will have to understand the ABC's (but that can wait for another day). When you start to learn a new technology, especially a Beta or CPT - you just want it to work, figuring out how it works can wait for another day.....

So I put together a simple WCF Web service, that you can just download and get running in a few minutes (for lazy developers - like myself!)

Getting Started

You are going to need Visual Studio 2005 (it might work with other versions of Visual Studio, but I've not tested in and I'm not going to!!), and .NET 3.0 (I would get the entire package from here instead).

Then just download the source from above.

Using the code

Download the example code and open up the solution in Visual Studio 2005.

The are two projects, the Web service and the Implementation of the class. [Fig 1]

Image 2

Fig 1 - showing the 2 projects

I have chosen to use the dev web server that is built into Visual Studio, it's just easier, less setup and mucking around. But there is no reason not to use IIS (if you know how to). When your code goes into production you will be using IIS, but for now I'm going to leave it alone.

There are two parts to the web service, the .svc file and the web.config.

WCFService.svc

C#
<% @ServiceHost Service="WCFSample.EchoImplementation"%>

Web.Config

C#
<system.serviceModel>
    <services>
        <service name="WCFSample.EchoImplementation" 
            behaviorConfiguration="returnFaults">
        <endpoint contract="WCFSample.IEchoContract" 
            binding="basicHttpBinding"/>
        <endpoint contract="IMetadataExchange" 
            binding="mexHttpBinding" address="mex">
        </endpoint>
    </service>
</services>

The Service from the ServiceHost attribute in the WCFService.svc file should match one of the service names in the web.config. The service name and endpoint contract should both match the implementation and contracts from the WCF Project Template.

The WCF Project Template is made up of 3 parts, the contract [data contract or message], the implementation and the interface [ServiceContract] (yes, the ABC's had to come in somewhere).

The Service Contract

The WCFContract.cs contains the interface for this service.

C#
[ServiceContract]
interface IEchoContract
{
    [OperationContract]
    EchoMessage Echo(EchoMessage Message);
}   

The Data Contract

The Message which gets sent around is contained in the WCFContract.cs

C#
[DataContract]
public class EchoMessage
{
    private string _OutMessage;
    private string _ReturnMessage;

    [DataMember]
    public string OutMessage
    {
        get { return _OutMessage; }
        set { _OutMessage = value; }
    }

    [DataMember]
    public string ReturnMessage
    {
        get { return _ReturnMessage; }
        set { _ReturnMessage = value; }
    }
}   

The Implementation

The implementation of the web service is in WCFImplementation.cs

C#
class EchoImplementation : IEchoContract
{
    public EchoMessage Echo(EchoMessage Message)
    {
        EchoMessage _returningMessage = new EchoMessage();

        _returningMessage.ReturnMessage = Message.OutMessage;

        return _returningMessage;
    }
}

For this example, I used the EchoMessage to pass the data between the client and the web service, but this could be any class that has [DataContract] as an attribute.

Your Go...

Now it's your turn. The code sample is a very simple service, but the structure can be copied for other web services, the example can be scaled out so there is a one to many or many to many relation between the .svc files and classes.

History

  • 1st Jan 2007 - Released Initial version

References

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Web Developer
United Kingdom United Kingdom
I've been a programmer for longer than I care to remember. It all started with those BBC (model B's) at school, it all went down hill from there.....

This year, I am mostly coding in.. C# (WPF & WCF)

Blog Address http://markpm.blogspot.com


Comments and Discussions

 
QuestionConsume the web service from a distant client Pin
yassine soutrani3-Jul-13 5:08
yassine soutrani3-Jul-13 5:08 
GeneralMy vote of 5 Pin
Patrick Harris1-Nov-12 5:52
Patrick Harris1-Nov-12 5:52 
Excellent. Where's part 2?

Thanks.
GeneralMy vote of 5 Pin
Sandesh M Patil11-Jun-12 3:41
Sandesh M Patil11-Jun-12 3:41 
GeneralMy vote of 5 Pin
Prasanta_Prince13-Sep-11 20:34
Prasanta_Prince13-Sep-11 20:34 
GeneralWhat Starts It Up? How Do You See It Working? Pin
hively4-May-11 8:12
hively4-May-11 8:12 
GeneralGood Job Pin
justinonday23-Feb-11 19:37
justinonday23-Feb-11 19:37 
GeneralBuilding a web service client with WCF Pin
Shameer Kunjumohamed17-Oct-10 5:54
Shameer Kunjumohamed17-Oct-10 5:54 
GeneralExcellent job! thx a lot! Pin
red_artikel8-Jul-10 11:36
red_artikel8-Jul-10 11:36 
GeneralIncorrect file in article Pin
Michael Bookatz27-May-09 4:34
Michael Bookatz27-May-09 4:34 
GeneralService WCF over C++ Client Pin
chemita_cpu6-Sep-07 0:49
chemita_cpu6-Sep-07 0:49 
Generaldbml & WCF Pin
Dogu Tumerdem13-Aug-07 4:46
Dogu Tumerdem13-Aug-07 4:46 
GeneralRe: dbml & WCF Pin
Mark Pryce-Maher13-Aug-07 4:55
Mark Pryce-Maher13-Aug-07 4:55 
GeneralRe: dbml & WCF Pin
Dogu Tumerdem13-Aug-07 5:37
Dogu Tumerdem13-Aug-07 5:37 
GeneralSimplicity is Beautiful Pin
Dewey29-Jul-07 15:31
Dewey29-Jul-07 15:31 
GeneralRe: Simplicity is Beautiful Pin
Mark Pryce-Maher7-Aug-07 21:18
Mark Pryce-Maher7-Aug-07 21:18 
QuestionFail to make it work Pin
niro@averna.com24-Jul-07 8:41
niro@averna.com24-Jul-07 8:41 
GeneralRe: Fail to make it work Pin
Mark Pryce-Maher7-Aug-07 21:17
Mark Pryce-Maher7-Aug-07 21:17 

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

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