Generating Clients and Services with Indigo - Generating a proxy using the Service Model Metadata Utility

In this section, you will generate a client proxy using the SvcUtil directly instead of using Add Service Reference. The purpose of this exercise is to show you how to exercise greater control over the generation of proxies and configuration settings.

1. First, run theHostproject so that the endpoint is available to generate a proxy.
   
   From the Windows Start menu, find the Microsoft Visual Studio 2005 program group and launch the Visual Studio 2005 Command Prompt. Run the following command to generate a new proxy for the client application and replace the application configuration settings generated previously: 
   
     svcutil /d:<YourLearningWCFPath>\
   Labs\Chapter1\HelloIndigo\Client /o:
     serviceproxy.cs /config:app.config http://localhost:8000/HelloIndigo
   
   The output should look similar to Figure1-24.
   
   The/d:option for SvcUtil allows you to provide a path where output files will be generated. In the Preface, I explained that I would be using the term <YourLearningWCFPath> to refer to your base path--where you unzipped the file provided with the book. Thus, if your base path is c:\LearningWCF, then your SvcUtil command in this example would be: 
   
     svcutil /d:c:\LearningWCF\Labs\ Chapter1\HelloIndigo\Client   /o:serviceproxy.cs/config:app.config   http://localhost:8000/HelloIndigo
   
   If your path includes spaces, such as c:\Learning WCF, then you will have to provide quotes to the path, as shown here:
   
     svcutil /d:"c\Learning WCF\Labs\ Chapter1\HelloIndigo\Client"   /o:serviceproxy.cs/config:app.config http://locahost:8000/
     HelloIndigo
   
2. To use this proxy you'll have to modify the client application. Go to theClient project. If you select the "Show all files" icon in Solution Explorer, you'll see a new file beneath the project node. Right-click serviceproxy.cs and select "Include in Project." Right-click localhost.map beneath Service References and select "Exclude from Project."
   
   Now open Program.cs and modify the code that constructs the service proxy. The proxy that was generated does not belong to a namespace, so you must remove the fully qualified name forHelloIndigoServiceClient. The resulting code is:
   
     using (HelloIndigoServiceClient proxy = new HelloIndigoServiceClient())
   
3. Compile and run the solution once again.

Now let's examine some of the ideas introduced in this lab in greater detail.

Figure 1-24.  Output generated when SvcUtil generates a service proxy and configuration settings for the client

Please check back next week for the continuation of this article.

Comments On: Generating Clients and Services with Indigo

· This article is an excerpt from the book "Learning WCF A Hands-on Guide," published...   >>> Post your comment now!

Buy this book...

This article is excerpted from chapter 1 of the book Learning WCF A Hands-on Guide, written by Michele Leroux Bustamante (O'Reilly, 2007; ISBN: 0596101627). Check it out today at your favorite bookstore. Buy this book now.