WCF Simple Example in Visual Studio 2010

You may also like...

47 Responses

  1. Avi says:

    How to “EmailService project”. Please explane.

  2. Dennis van der Stelt says:

    @Avi: WHAT?

  3. Divya says:

    If my host and client are in two different solutions , will that make any difference?

  4. Dennis van der Stelt says:

    Even if you run them both on different computers it would work. That’s the entire point of WCF, connecting systems in a dstributed environment 🙂

  5. Ray says:

    Ah I should have posted my last question here on this updated tutorial. For a web service in sharepoint I declare the service factory and basichttpbinding in the svc file then deploy. Thus no need for settings in a config file. I can browse to the ***.svc/mex URL (enabled via attribute in service class) but not to the _vti_bin/xxx.svc file nor if I append the ?wsdl to it. I get the wsdl on the mex page. Would be nice to see details of the contract on the svc page in the browser. How could I enable this please? Thank you Dennis.

  6. Basudeb says:

    This is a fantastic tutorial for total Noobs who are new to both .NET and WCF. Case in point: me :). Working through an example like this is the best way to conceptually understand how WCF works. So Kudos to you, Dennis for putting this together.

  7. ajk says:

    very nice explanation, could you please expalin wcf with a good example, which covers every thing about wcf in a single application

  8. Leung says:

    Hi, i have an error in error list in EmailValidator.cs

    it saying the name ‘Regex’ does not exist in the current context.

    code as below, can you tell me what is the solution?

    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Text;
    using System.ServiceModel;

    namespace EmailService
    public class EmailValidator : IEmailValidator
    public bool ValidateAddress(string emailAddress)
    Console.WriteLine(“Validating: {0}”, emailAddress);

    string pattern = @”^([0-9a-zA-Z]([-.w]*[0-9a-zA-Z])*@(([0-9a-zA-Z])+([-w]*[0-9a-zA-Z])*.)+[a-zA-Z]{2,9})$”;
    return Regex.IsMatch(emailAddress, pattern);

  9. Dennis van der Stelt says:

    @Leung : The Regex should be in System.Text as far as I know. It’s a static class in the .NET Framework. So if you can’t find it, something’s wrong with your setup. Might be incorrect .NET version, although very unlikely.

    Anyway, just return true as it interferes with the WCF experience right now.

    public bool ValidateAddress(string emailAddress)


    Console.WriteLine(“Validating: {0}”, emailAddress);

    return true;

  10. Kishore says:

    I also got the same error. Even though .NET 4.0 should have it by default; i.e. System.Text

    You can add one more reference to resolve the issue.

    using System.Text.RegularExpressions;
    That’ll take care of the issue.

  11. BlackCat says:

    Excellent tutorial! Very useful for someone (re)starting .NET, VS and WCF. Thanks.

  12. Biju says:

    Thankyou Dennis!!!
    Very simple and descriptive tutorial…

  13. Aarti Varadkar says:

    Awesome 🙂
    Excellent tutorial for WCF beginner

  14. jason says:

    I spent about a week looking for a very concise, simple explanation of WCF and then I found your site. Thank you very much!!!!

  15. Martijn says:

    Thanks for the great articles Dennis!

    I have one question: what would be the way to to create a function in the ConsoleHost to process the input from the Service application (instead of processing the input directly in the service application object)?

  16. Ollie says:

    The best self-hosting WCF “getting started” tutorial I have seen!

  17. sherry says:

    Nice article. I am new to c# and WCF.

    I am kind of lost in this step

    Type serviceType = typeof(EmailValidator);

    The type or namespace emailvalidator is not found are u missing a using directive or an assembly reference) ?

    So I know that I need to add referemce to ConsoleHost from WCFSimpleExample2010 how can I do that?

    And also I read in your replies that I can do this in 2 differnt computers lets say I created WCFSimpleexample2010 in one system and ConsoleHost in another system how can I add the reference to it?

    please let me know


  18. Sherry says:

    I added the reference and I can add only IEmailValidator and If I add EMailValidator I am getting error message.

  19. azizi says:

    Thanks for really easy example.

    1- I know the concept of your project is same as the WCF project but why you didn’t new a WCF project and used console application?

    2- Do you know how we can connect to SQL via Entity Data Model in addition to WCF service, because I want develop an application which can to get some information via WCF and then save them in SQL via Entity Data Model. If there is some useful link please send me or share it here.

    [email protected]

  20. Dennis van der Stelt says:

    @Sherry : Have you got a class EmailValidator at all? Do you have casing right, because you’re writing EMailValidator while it should be EmailValidator.

    Put your cursor on the word EmailValidator and press and hold the CTRL key and then press the . key (while holdering CTRL). A context menu should appear, asking you to either create a class (which is wrong) or add a using statement for the EmailValidator. That should do it.

    The console application is just to get WCF up and running. You can also let IIS do this for you. What you really need is the IEmailService for specifying which operations should be visible/usable on the service and of course EmailService, because an interface alone doesn’t do anything.

    But you need WCF being activated on both sides. I did it with a console application, and than you need a console app on both sides. One for sending a message, one for receiving a message. But you can also do this in Windows Forms, WPF or whatever. The receiving side however is, most of the time, in IIS or in a Windows service.

  21. Dennis van der Stelt says:


    1- Because I like to be in control! 🙂 And also because when you start completely blank, it’s easier to explain what really is happening. When Visual Studio already generates tons of code and config for you, it’s harder to explain what you actually need.

    2- There’s a ton of info out there and it depends on what you need. But WCF RIA of Data Services or whatever already helps a lot. But you can also just transfer the EF entities over the wire, because they can be serialized by WCF.

  22. bhups says:

    i face a problem during the proxy creation manually and also with easy way..,pls help me….

    the problem as follow –

    /// error in visual studio 2010 commmand prompt

    WS-Metadata Exchange Error
    URI: http://localhost:8080/

    Metadata contains a reference that cannot be resolved: ‘http://localhost:808

    There was no endpoint listening at http://localhost:8080/ that could accept
    the message. This is often caused by an incorrect address or SOAP action. See In
    nerException, if present, for more details.

    Unable to connect to the remote server

    No connection could be made because the target machine actively refused it 1

    HTTP GET Error
    URI: http://localhost:8080/

    There was an error downloading ‘http://localhost:8080/’.

    Unable to connect to the remote server

    No connection could be made because the target machine actively refused it 1

  23. Dennis van der Stelt says:

    There’s a problem with the service.

    Make sure you have a MEX endpoint in your config and try to access the http endpoint via a browser.

  24. Amit Trivedi says:

    I am getting following error when I run the ConsoleHost Application.

    Error :
    Service ‘EmailService.EmailValidator’ has zero application (non-infrastructure) endpoints. This might be because no configuration file was found for your application, or because no service element matching the service name could be found in the configuration file, or because no endpoints were defined in the service element.

    Please help me.


  25. Tomek says:

    Very good tutorial, well explained, thank you.

  26. Ingo says:

    ThanX Dennis,
    a very good example and lotZ of help for one to dive into WCF.

  27. Deepti says:

    Iam creating all 3 projects.. when iam running svcutil.exe .. it is creating file… but its not showing in console client project.. do i have to add manualay it comes automatically in the projects.. once utility is run..
    Please help

  28. Mojtaba tavakoli says:

    ok tanx for informing me.thank you

  29. Quen Wilson - IoW (UK) says:

    Came across this fine example. Had a play and works well. Possibly MS needs to develop a higher level using drag-and-drop tools onto a form. The more I get into this (and always had a fascination with distributed computing), the more balls I seem to have in the air. It’s certainly different from standalone Win Services, remoting, channels, etc. Question though: How is this placed with respect to Service Broking and MS SQL Server? Can I contract directly into MS Server avoiding some of the trappings of ADO.Net, possibly using Linq?
    However, great work. Love the clarity of writing and explanation. Thx Dennis.

  30. Tugce says:

    I did exactly what is written above. (until “Accessing the metadata” part ) when I type to the browser http://localhost:8080/ page didnt show up. What is the problem and how can I fix this?

  31. Dennis van der Stelt says:

    @Tugce: So many possibilites, that I can’t think of anything specific when you provide me so little information. Sorry! 🙁

  32. Dennis van der Stelt says:

    @Quen: Don’t know if I have every answer and if you’re looking for the answers I give you.

    – Service Broker is a queueing technology that is WAY harder to get into than WCF with MSMQ or nServiceBus or so. I’d ditch Service Broker if I were you.
    – SQL Server has nothing to do with WCF. SQL is a data store, WCF is a communication mechanism.
    – If you want to access data, this has also nothing to do with WCF. I’d use Entity Framework if you’re going for Microsoft, or nHibernate if you up for it. Both technologies need a lot of investment to gain knowledge.

    About the channels etc, that’s what WCF uses. Not sure what you mean. If you mean .NET Remoting, it’s dead. You can use TCP/IP with WCF as well.

    Windows Services are a way of hosting your application. They can host WCF services as well. But if you have IIS7 and WAS (Windows Process Activation Services) it’s probably VERY unwise to host them yourself in Win Services.

  33. John Murray says:

    I would really like to understand this but it suffers from a very common disease – it assumes the reader can read minds and is really out of touch in understanding what a beginner needs explaining. – I am fine with the instructions to open new project and solution from the WCF templates (except that VS2010 offers no option for ‘class library’ as stated inn the text – only ‘wcf service library’ is an option – so I choose that – the next statement in the tutorial is ‘now create a contract’ – be useful to explain how, why or what. I managed to guess I had to right click in solution explorer and add something new. When I did I couldn’t find anything called a “contract” in the list of templates only WCF service class or -(eureka) ‘interface’ (not what was written in your tutorial)
    so I got there – I am using VS2010 v10 sp1 – is it that this tutorial is based on something planetarilly different? or is the writing a rushed job skipping the boring steps –
    Sorry to complain -you’ve got lots of warm fuzzies from others which I am sure you richly deserve if only for taking the effort to publish this but if you see yourself as a teacher and you are pitching this at noobies then perhaps the getting started phase deserves more attention.
    surely it is not the most difficult thing in the world to document exactly what steps take you to what point?

  34. Dennis van der Stelt says:

    Hey John, the writing is most certainly not a rushed job. But if you’re not sure about “Class Library” and all, perhaps it’s not wise to start with WCF. It’s pretty complex. This and my other tutorial on WCF, are some of the most easy and complete you can find. If not, let me know which one you found more comfortable.

    When I have time, I’ll have a look at it again.

  35. Basti says:

    I just stepped over your new WCF articel and as far i can see now its great! This will safe me some time!
    Thx alot!

    @John: Meybe Dennis’ way to explain the contract is not straght forwared. I was irritated too, but if you read just a few line more you’ll find the ServiceContract which was meant.

  36. Dennis van der Stelt says:

    Hehehehe, I changed it a bit. Hope it’s more clear now.

  37. dmark says:


    If you can’t see the EmailValidator class, it’s because you forgot to put “public” in front of the class definition.

    Just add it, and you’ll be all set.

  38. Bamboula36 says:

    Hi Dennis,

    First,I want to thank you for this great tutorial.

    I’ve followed all the steps and everything has been fine till now.
    I’m trying to create proxy whith Visual Studio 2010 (the easy way). I’ve the “Add Service Reference” window open and I’ve entered the address:
    When I click on Go, I get this message:
    An error occured while attempting to find services at ‘http://localhost:8080/’.

    Maybe did I forget something? or maybe did I mistake somewhere? Do you have an idea?


  39. Dennis van der Stelt says:

    @Bamboula36 : Could really be anything, but I’m 99% sure there’s something wrong in the configuration. Did you add more than in the example code? Did you download the example solution?

  40. Johnson says:

    I follow your article step by step up to the display of the dispatchers which display correctly but my browsers are displaying server not found when i type the uri into them i.e http://localhost:8080/. I have checked all browser settings. I want to get this done before progressin with the tutoria. Thanks.
    [email protected]

  41. Dennis van der Stelt says:

    @Johnson : Did you add the “httpGetEnabled” attribute in your configuration? That’s the part that enables browsers to look at the wsdl

  42. I went through the example, but my project doesn’t load, I’m using VS 2008. Do I have to use VS 2010 for it to work? Thanks.

  43. Dennis van der Stelt says:

    No, you should be able to use VS2008 for this. Just the supplied downloadable solution won’t easily load in VS2008 🙂

  44. Dennis S says:

    Straight on, the service wouldn’t start until I started VS2010 “run as administrator”. This wasn’t mentioned in the narrative.

  45. Dennis S says:

    In the section about adding the mex, you did not specify that you had to actually CREATE an app.config file in ConsoleHost. That slowed me down. After finally adding one and retrying svcutil, that worked. Another missed step was that you didn’t specify that you had to add a reference to ServiceModel in the ConsoleClient. These two things, coupled with the step mentioned in my previous post, made this example take hours to try instead of minutes. It did finally work as advertised.

  46. Dennis van der Stelt says:

    @Dennis S: Thanks for the heads up, I’ll see if I can revision the article to make it more clear.

Click on a tab to select how you'd like to leave your comment

Leave a Reply

Your email address will not be published. Required fields are marked *