Microsoft Virtual Labs

The Fundamentals of
Programming the Windows
Communication Foundation
The Fundamentals of Programming the Windows Communication Foundation

Table of Contents
The Fundamentals of Programming the Windows Communication Foundation .................. 1
Exercise 1 Developing a Software Resource .................................................................................................................2
Exercise 2 Building a Service for Accessing the Resource ...........................................................................................3
Exercise 3 Using the Service .......................................................................................................................................14
Exercise 4 Hosting the Service in IIS ..........................................................................................................................19
Exercise 5 Securing the Service ..................................................................................................................................23
Exercise 6 Debugging..................................................................................................................................................30
The Fundamentals of Programming the Windows Communication Foundation

The Fundamentals of Programming the

Windows Communication Foundation
After completing this lab, you will be better able to:
Objectives ƒ Develop a software resource.
ƒ Building a Windows Communication Foundation service to access that
resource.
ƒ Use the service.
ƒ Host the service in IIS.
ƒ Secure the service.
ƒ Debug.
This lab demonstrates how to build a Windows Communication Foundation
Scenario service and client, and how easily those services can be modified. You’ll host
the service first in a .NET console application and then in IIS, and also secure the
communication between the client and service.
You’ve developed an application that calculates the value of derivatives, a
financial entity whose value is based on the performance of another entity. For
instance, a stock option is a derivative that depends on the value of the stock.
Now that you’ve built this difficult and in-demand application, you want to
enable other software systems to access it. Of course, you also want to secure
this sensitive communication to protect your valuable information. In this lab,
you’ll see how the Windows Communication Foundation lets you do all these
things easily.

Estimated Time to 90 Minutes

Complete This Lab

Page 1 of 30
The Fundamentals of Programming the Windows Communication Foundation

Exercise 1
Developing a Software Resource

Scenario
Of course, while actually writing software to calculate the value of derivatives is beyond the scope of this lab, one
can pretend to do so by following these steps.

Tasks Detailed Steps

1. Develop a software a. Open Microsoft Visual Studio 2005, choose File | New | Project from the
resource. menus.
b. In the New Project window, select Visual C# in the Project types: pane, and
select Class Library in the Templates: pane.
c. In the Name: field, type DerivativesCalculator.
d. In the Location field, type C:\.
e. In the SolutionName field, type DerivativesCalculatorSolution.
f. Click Ok.
g. In the Solution Explorer, rename the class file, Class1.cs, in the
DerivativesCalculator project to Calculator.cs, and modify its content to look
like like: (This code can be found in C:\Snippets\lab1 Snippets.txt) (Snippet 1)
using System;
using System.Collections.Generic;
using System.Text;

namespace DerivativesCalculator
{
public class Calculator
{
public decimal CalculateDerivative(
string[] symbols,
decimal[] parameters,
string[] functions)
{
//Pretend to calculate the value of a derivative.
return
(decimal)(System.DateTime.Now.Millisecond);
}
}
}
This simple C# class purports to calculate the value of derivatives, and will serve to
represent a piece of software with which one might like other software to be able to
communicate. Certainly, if the class really could calculate the value of derivatives, its
capabilities would be in extraordinary demand, and one could quickly earn a fortune
by charging for access to it.

Page 2 of 30
The Fundamentals of Programming the Windows Communication Foundation

Exercise 2
Building a Service for Accessing the Resource

Scenario
To allow other software to communicate with the class, one can use the Windows Communication Foundation
Service Model to add communication facilities to it. One does so by building a Windows Communication
Foundation service with an endpoint for accessing the facilities of the derivatives calculator class. In the language
of the Windows Communication Foundation Service Model, an endpoint consists of an address, a binding, and a
contract.

Tasks Detailed Steps

1. Define the contract. In using the Windows Communication Foundation Service Model, one usually begins
by defining the contract. The contract specifies the operations that are available at
the endpoint. Once the contract has been defined, then the next step is to implement
the contract, to actually provide the operations that it defines.
Defining and implementing Windows Communication Foundation contracts is very
simple. To define a contract, one merely writes an interface in one’s favorite .NET
programming language, and adds attributes to it to indicate that the interface is also a
Windows Communication Foundation contract. Then, to implement the contract, one
merely writes a class that implements the .NET interface that one has defined.
a. In the Solution Explorer, right click the DerivativesCalculatorSolution solution,
and click Add | New Project.
b. Add a C# Class Library project called, DerivativesCalculatorService, to the
solution.
c. Rename the class file, Class 1.cs, in the DerivativesCalculatorService project to,
IDerivativesCalculator.cs.
d. Modify the contents of the IDerivatesCalculator.cs file to look like so: (Snippet
2)
using System;
using System.Collections.Generic;
using System.Text;

namespace DerivativesCalculator
{
public interface IDerivativesCalculator
{
decimal CalculateDerivative(
string[] symbols,
decimal[] parameters,
string[] functions);

void DoNothing();
}
}
e. For this lab, we will be using the namespace DerivativesCalculator for both
projects. Modify the namespace of the IDerivativesCalculator interface to be
DerivativesCalculator.
f. IDerivativesCalculator is an ordinary C# interface, with two methods,
CalculateDerivative() and DoNothing(). Now it will be made into a Windows

Page 3 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
Communication Foundation contract.
g. Choose Project | Add Reference from the Visual Studio 2005 menus, select
System.ServiceModel from assemblies listed on the .NET tab of the Add
Reference dialog that appears, and click on the OK button. System.ServiceModel
is the more important of the two new class libraries that the Windows
Communication Foundation adds to the .NET Framework Class Library 2.0.
h. Modify the IDerivativesCalculator interface in the IDerivativesCalculator.cs
module to import the classes in the System.ServiceModel namespace that is
incorporated in the System.ServiceModel assembly: (Snippet 3)
using System;
using System.Collections.Generic;
using System.ServiceModel;
using System.Text;

namespace DerivativesCalculator
{
public interface IDerivativesCalculator
{
decimal CalculateDerivative(
string[] symbols,
decimal[] parameters,
string[] functions);

void DoNothing();
}
}
i. Now designate the IDerivativesCalculator interface as a Windows
Communication Foundation contract by adding the ServiceContract attribute that is
included in the System.ServiceModel namespace: (Snippet 4)
using System;
using System.Collections.Generic;
using System.ServiceModel;
using System.Text;

namespace DerivativesCalculator
{
[ServiceContract]
public interface IDerivativesCalculator
{
decimal CalculateDerivative(
string[] symbols,
decimal[] parameters,
string[] functions);

void DoNothing();
}
}
j. Use the OperationContract attribute to designate the CalculateDerivative() method
of the IDerivativesCalculator interface as one of the methods of the interface that is
to be included as an operation in the Windows Communication Foundation
contract: (Snippet 5)
using System;

Page 4 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
using System.Collections.Generic;
using System.ServiceModel;
using System.Text;

namespace DerivativesCalculator
{
[ServiceContract]
public interface IDerivativesCalculator
{
[OperationContract]
decimal CalculateDerivative(
string[] symbols,
decimal[] parameters,
string[] functions);

void DoNothing();
}
}
k. By default, the namespace and name of a Windows Communication Foundation
contract are the namespace and name of the interface to which the ServiceContract
attribute is added. Also, the name of an operation included in a Windows
Communication Foundation contract is the name of the method to which the
OperationContract attribute is added. One can alter the default name of a contract
using the Namespace and Name parameters of the ServiceContract attribute, as in,
[ServiceContract(Namespace=”MyNamespace”,Name=”MyContract”
)]
public interface IMyInterface
l. One can alter the default name of an operation with the Name parameter of the
OperationContract attribute:
[OperationContract(Name=”MyOperation”]
string MyMethod();
m. Returning to the derivatives calculator solution in Visual Studio 2005, now that a
Windows Communication Foundation contract has been defined, the next step is to
implement it. In the DerivativesCalculatorService project, choose Project | Add
Class from the Visual Studio 2005 menus, and add a class called,
DerivativesCalculatorServiceType.cs, to the project.
n. Modify the contents of the DerivativesCalculatorServiceType.cs class file to
look like this: (Snippet 6)
using System;
using System.Collections.Generic;
using System.Text;

namespace DerivativesCalculator
{
public class DerivativesCalculatorServiceType:
IDerivativesCalculator
{
#region IDerivativesCalculator Members
decimal
IDerivativesCalculator.CalculateDerivative(
string[] symbols,
decimal[] parameters,
string[] functions)

Page 5 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
{
throw new Exception("The method or operation
is not implemented.");
}

void IDerivativesCalculator.DoNothing()
{
throw new Exception("The method or operation
is not implemented.");
}
#endregion
}
}
In the language of the Windows Communication Foundation, the name, service type is
used to refer to any class that implements a service contract. So, in this case, the
DerivativesCalculatorServiceType is a service type because it implements the
IDerivativesCalculator interface, which has been designated as a Windows
Communication Foundation service contract.
A class can be a service type not only by implementing an interface that is a service
contract, but also by having the ServiceContract attribute applied directly to the class.
However, by applying the ServiceContract attribute to an interface and then
implementing the interface with a class, as in the foregoing, one yields a service
contract that can be implemented with any number of service types. In particular, one
service type that implements the service contract can be discarded in favor of another.
If the service contract attribute is instead applied directly to a class, then that class
and its descendants will be the only service types that can implement that particular
service contract, and discarding the class will mean discarding the service contract.
o. At this point, the DerivativesCalculatorServiceType implements the
IDerivativesCalculator interface in name only. Its methods do not actually
perform the operations described in the service contract. Rectify that now by
returning to the DerivativesCalculatorService project in Visual Studio 2005, and
choosing Project | Add Reference from the menus. Select the Projects tab, select
the entry for the DerivativesCalculator project, and click on the OK button.
p. Now program the CalculateDerivative() method of the
DerivativesCalculatorServiceType to delegate the work of calculating the value
of a derivative to the Calculator class of the DerivativesCalculator project,
which was the original class with which other pieces of software were to be able to
communicate. Also modify the DoNothing() method of the
DerivativesCalculatorServiceType so that it no longer throws an exception.
(Snippet 7)
using System;
using System.Collections.Generic;
using System.Text;

namespace DerivativesCalculator
{
public class DerivativesCalculatorServiceType:
IDerivativesCalculator
{
#region IDerivativesCalculator Members
decimal
IDerivativesCalculator.CalculateDerivative(
string[] symbols,

Page 6 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
decimal[] parameters,
string[] functions)
{
return new Calculator().CalculateDerivative(
symbols, parameters, functions);
}

void IDerivativesCalculator.DoNothing()
{
return;
}
#endregion
}
}
q. Choose Build | Build Solution from the Visual Studio 2005 menu to ensure that
there are no programming errors.
2. Host the Service. In order to enable other software to use the derivatives calculator class, one must
create a Windows Communication Foundation service by which the functionality of
the derivatives calculator class is exposed. Windows Communication Foundation
services are collections of endpoints, each endpoint consisting of an address, a
binding, and a contract. At this point, the contract portion of an endpoint for
accessing the facilities of the derivatives calculator has been completed, the contract
having been defined and implemented.
The next step is to provide for hosting the service within an application domain.
Application domains are the containers that Microsoft’s Common Language Runtime
provides for .NET assemblies. So, in order to have an application domain to host a
Windows Communication Foundation service, some Windows process will need to
initialize the Common Language Runtime on behalf of the service. Any .NET
application can be programmed to do that. IIS can also be made to have Windows
Communication Foundation services hosted within application domains. To begin
with, the Derivatives Calculator Service will be hosted in an application domain
within a .NET application, and then, later, within an application domain in IIS.
a. Choose File | New | Project from the Visual Studio 2005 menus.
b. Uncheck the Create directory for solution check box.
c. In the Project Types: pane, select Visual C# | Windows.
d. In the Templates: pane, select Console Application.
e. In the Solution combo box, select Add to Solution.
f. Add a C# console application called Host to the derivatives calculator solution.
g. Click Ok.
h. Select Project | Add Reference from Visual Studio 2005 menus, and, from the
.NET tab of the Add Reference dialog, add a reference to the
System.ServiceModel assembly. Add a reference to the System.Configuration
assembly in the same way.
i. Choose Project | Add Reference from the Visual Studio 2005 menus, and, from
the Projects tab, add a reference to the DerivativesCalculatorService project.
j. Modify the contents of the Program.cs class module in the Host project to match
this: (Snippet 8)
using System;
using System.Collections.Generic;
using System.Text;
using System.Configuration;

Page 7 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
using System.ServiceModel;
using DerivativesCalculatorService;

namespace DerivativesCalculator
{
public class Program
{
public static void Main(string[] args)
{
Type serviceType =
typeof(DerivativesCalculatorServiceType);

string httpBaseAddress =

ConfigurationManager.AppSettings["HTTPBaseAddress"];
string tcpBaseAddress =

ConfigurationManager.AppSettings["TCPBaseAddress"];
Uri httpBaseAddressUri = new
Uri(httpBaseAddress);
Uri tcpBaseAddressUri = new
Uri(tcpBaseAddress);
Uri[] baseAdresses = new Uri[] {
httpBaseAddressUri,
tcpBaseAddressUri};

using(ServiceHost host = new ServiceHost(

serviceType,
baseAdresses))
{
host.Open();

Console.WriteLine(
"The derivatives calculator service is
available."
);
Console.ReadKey();

host.Close();
}
}
}
}
The key lines in that code are these:
using(ServiceHost host = new ServiceHost(
serviceType,
baseAdresses))
{
host.Open();

…
host.Close();
}

Page 8 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
ServiceHost is the class provided by the Windows Communication Foundation Service
Model for programming .NET applications to host Windows Communication
Foundation endpoints within application domains. In listing 2.2, a constructor of the
ServiceHost class is given information to identify the service type of the service that is
to be hosted. The constructor is also given an array of uniform resource identifiers
(URIs). Those URIs are Windows Communication Foundation base addresses from
which the actual addresses of each hosted Windows Communication Foundation
endpoint will be derived. In this particular case, two base addresses are provided,
and those base addresses are retrieved from the application’s configuration file.
Consequently, a configuration file with those base addresses must be created.
k. Use the Project | Add New Item menu to add an Application Configuration
File named, app.config, to the DerivativesCalculatorService project.
l. Modify the contents of the app.config file in this way: (Snippet 9)
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<appSettings>
<add key="HTTPBaseAddress"
value="http://localhost:8000/Derivatives/"/>
<add key="TCPBaseAddress"
value="net.tcp://localhost:8010/Derivatives/"/>
</appSettings>
</configuration>
Here, the URIs used as base addresses are, http://localhost:8000/Derivatives/, and
net.tcp://localhost:8010/Derivatives/. The expression preceding the initial colon of a
URI is called, the schema, so the schema of these URIs is http and tcp. In providing
base addresses to the Windows Communication Foundation ServiceHost, the URI for
each base address must have a unique schema.
m. Choose Build | Build Solution from the Visual Studio 2005 menu to ensure that
there are no programming errors.
3. Specify and address A Windows Communication Foundation endpoint consists of an address, a binding,
as a binding. and a contract. A contract has been defined and implemented for the endpoint that
will be used to provide access to the derivatives calculator class. To complete the
endpoint, it is necessary to provide an address and a binding.
Specifying an address and binding for an endpoint does not require writing any code,
and is customarily the work of an administrator rather than a programmer. Providing
an address and a binding can be done in code. However, that would require having to
modify the code in order to change the address and the binding of the endpoint. A key
innovation of the Windows Communication Foundation is to separate how software is
programmed from how it communicates, which is what the binding specifies. So,
generally, one avoids the option of specifying the addresses and bindings of endpoints
in code. The alternative is to specify them in configuring the host.
a. Modify the app.config file of the Host project to look like this: (Snippet 10)
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<appSettings>
<add key="HTTPBaseAddress"
value="http://localhost:8000/Derivatives/"/>
<add key="TCPBaseAddress"
value="net.tcp://localhost:8010/Derivatives/"/>
</appSettings>
<system.serviceModel>
<services>

Page 9 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
<service type=
"DerivativesCalculatorService.DerivativesCalculatorService
Type,DerivativesCalculatorService">
<endpoint
address="Calculator"
binding="basicHttpBinding"
contract=
"DerivativesCalculatorService.IDerivativesCalculator,Deriv
ativesCalculatorService"
/>
</service>
</services>
</system.serviceModel>
</configuration>
b. Choose Build | Build Solution from the Visual Studio 2005.
In the XML,
<service type=
"DerivativesCalculator.DerivativesCalculatorServiceType,De
rivativesCalculatorService">
identifies the configuration of the DerivativesCalculatorServiceType hosted by the
Host application. The expression,
"DerivativesCalculator.DerivativesCalculatorServiceType,De
rivativesCalculatorService"
is the name of the DerivativesCalculatorServiceType in a standard .NET format,
which is called the assembly-qualified name format. In the expression,
DerivativesCalculator is the namespace of the service type,
DerivativesCalculatorServiceType is the name of the service type itself, and
DerivativesCalculatorService is the display name of the assembly that contains the
service type.
The configuration defines a single endpoint at which the facilities exposed by the
service type will be available. The address, the binding, and the contract constituents
of the endpoint are all specified.
The contract constituent is identified by giving the assembly-qualified name of the
interface that defines the service contract implemented by the service type,
DerivativesCalculatorServiceType. That interface is IDerivativesCalculator, which is
in the DerivativesCalculatorService assembly:
contract=
"DerivativesCalculator.IDerivativesCalculator,DerivativesC
alculatorService"
The binding constituent of the endpoint is specified in this way:
binding="basicHttpBinding"
To understand what that signifies, one must understand Windows Communication
Foundation bindings.
A Windows Communication Foundation binding is a combination of binding elements.
Binding elements are the primary constituents provided by the Windows
Communication Foundation’s Channel Layer.
One special category of binding element consists of those that implement protocols for
transporting messages. One of those is the binding element that implements the
hypertext transport protocol (HTTP). Another is the binding element that implements
the transmission control protocol (TCP).
Another special category of binding element consists of those that implement protocols

Page 10 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
for encoding messages. One of those is a binding element for encoding XML
Information Sets (InfoSets) as text. Another is a binding element for encoding XML
InfoSets in a binary format.
A Windows Communication Foundation binding is a collection of binding elements
that must include at least one transport protocol binding element, one or more
message-encoding protocol binding element, and zero or more other binding elements.
Bindings may be defined by selecting individual binding elements, either in code, or in
configuration. However, the Windows Communication Foundation provides a number
of classes that represent common selections of binding elements. Those classes are
referred to as the standard bindings.
One of the standard bindings is the BasicHttpBinding. The BasicHttpBinding
represents the combination of HTTP transport binding element and the binding
element for encoding XML InfoSets in text format. The BasicHttpBinding class
configures those binding elements in accordance with the WS-I Basic Profile
Specification 1.1, which is a combination of Web service specifications chosen to
promote interoperability among Web services and consumers of Web services on
different platforms.
All the current standard bindings are listed in table 2.1 below. They all derive from
the class, System.ServiceModel.Binding.
Windows Communication Foundation Standard Bindings
Name Purpose

BasicHttpBinding Maximum interoperability through

conformity to the WS-BasicProfile 1.1
WSHttpBinding HTTP communication in conformity with
WS-* protocols
WSDualHttpBinding Duplex HTTP communication, by which
the receiver of an initial message will
not reply directly to the initial sender,
but may transmit any number of
responses over a period of time

WSFederationBinding HTTP communication, in which access to

the resources of a service can be
controlled based on credentials issued
by an explicitly-identified credential
provider
NetTcpBinding Secure, reliable, high-performance
communication between Windows
Communication Foundation software
entities across a network

NetNamedPipeBinding Secure, reliable, high-performance

communication between Windows
Communication Foundation software
entities on the same machine
NetMsmqBinding Communication between Windows
Communication Foundation software

Page 11 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
entities via Microsoft Message Queuing
(MSMQ)
MsmqIntegrationBindi Communication between a Windows
ng Communication Foundation software
entity and another software entity via
MSMQ

NetPeerTcpBinding Communication between Windows

Communication Foundation software
entities via Windows Peer-to-Peer
Networking

This specification, in the configuration of the endpoint for the

DerivativesCalculatorService,
binding="basicHttpBinding"
identifies the BasicHttpBinding as the binding for that endpoint. The lower-case of
the initial letter, b, is in conformity with a convention of using camel-casing in
configuration files.
The address specified for the endpoint in the configuration of the
DerivativesCalculatorService in listing 2.3 is Calculator. That address for the
endpoint is relative to a base address. Which of the base addresses provided to the
host of a service is the base address for a given endpoint is determined based on the
scheme of the base address, and the transport protocol implemented by the transport
binding element of the endpoint, as shown in table 2.2, below. The transport protocol
implemented by the transport binding element of the endpoint is the HTTP protocol,
so, based on the information in table 2.2, the base address for the endpoint is
http://localhost:8000/Derivatives/. Therefore, the absolute address for the endpoint is
http://localhost:8000/Derivatives/Calculator.
Mapping of Base Address Schemes to Transport
Protocols
Base Address Scheme Transport Protocol
http HTTP
net.tcp TCP
net.pipe Named Pipes
net.msmq MSMQ

In the foregoing steps, the service was configured using the XML in listing 2.3. If one
thinks it unlikely that system administrators will be pleased to have to write XML to
configure services, then it is important to know that the Windows Communication
Foundation provides a tool for configuring services by which one can avoid having to
write XML to do so. That tool is the Microsoft Service Configuration Editor,
SvcConfigEditor.exe. That tool may be found in the \Program Files\Microsoft
SDKs\Windows\v1.0\Bin folder of the drive on which the SDK was installed.
4. Deploy the service. Now an address, a binding, and a contract have been provided for the Windows
Communication Foundation endpoint at which the facilities of the derivatives
calculator class will be made available. An application domain for hosting the service
incorporating that endpoint has also been provided, or, to be more precise, it will be

Page 12 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
provided as soon as the Host console application is executed.
a. Execute that application now by right-clicking on the Host entry in the Visual
Studio 2005 Solution Explorer, and selecting Debug | Start New Instance from
the context menu. After a few seconds, the console application window of the host
should appear.
The Windows Communication Foundation has examined the code in the Host and
DerivativesCalculatorService assemblies, as well as the contents of the Host
assembly’s configuration file. The code and the configuration use the Windows
Communication Foundation’s Service Model to define a service for accessing the
derivatives calculator class. From that code and that configuration, the Windows
Communication Foundation generates and configures the service using the
programming framework constituted by the classes of the Channel Layer. In
particular, it employs the binding element classes that are used by the
BasicProfileBinding class that was selected as the binding for the service. Then the
Windows Communication Foundation loads the service into the default application
domain of the Host console application.
b. Confirm that the Windows Communication Foundation service for accessing the
capabilities of the derivatives calculator class is available by directing a browser to
the HTTP base address that was provided to the ServiceHost:
http://localhost:8000/Derivatives/.
A similar page can be retrieved for any Windows Communications Foundation service
with a host that has been provided with a base address with the scheme, http. It is not
necessary that the service have any endpoints with addresses relative to that base
address.
c. Add the query, wsdl, to the URI at which the browser is pointing, by pointing the
browser at http://localhost:8000/Derivatives/?wsdl, and the WSDL for the
service should be displayed.
d. Close Internet Explorer.

Page 13 of 30
The Fundamentals of Programming the Windows Communication Foundation

Exercise 3
Using the Service

Scenario
Now a Windows Communication Foundation service is available for accessing the facilities of the derivatives
calculator class. The Windows Communication Foundation can be employed to construct a client for the derivatives
calculator, a software entity that will use the facilities of the derivatives calculator via the service.

Tasks Detailed Steps

1. Use the service with For the following steps, access to the tools provided with the Windows
a Windows Communication Foundation from a .NET command prompt will be required. That
Communication access is provided by a command prompt that should be accessible by choosing All
Foundation Client. Programs|Microsoft Windows SDK|CMD Shell. That command prompt shall
henceforth be referred to as the Microsoft Windows Vista DEBUG Build Environment
prompt. From that prompt, the Windows Communication Foundation’s Service
Metadata Tool, SvcUtil.exe, will be used to generate components of the client for the
derivatives calculator.
a. If the Host console application had been shut down, start an instance of it, as
before.
b. Click Start | All Programs | Microsoft Windows SDK | CMD Shell.
c. Enter,
C:
and then,
cd c:\DerivativesCalculatorSolution
at that prompt to make to the derivatives calculator solution folder the current
directory.
d. Next, enter,
svcutil http://localhost:8000/Derivatives/
/out:Client.cs /config:app.config
The command executes the Windows Communication Foundation’s Service Metadata
Tool passing it a base address of a service that has the scheme, http. In this case, it is
passed the base address of the derivatives calculator service constructed by the earlier
steps in this chapter. Given a base address of a Windows Communication Foundation
service, provided it is an address with scheme, http, the Service Metadata Tool can
retrieve the WSDL for the service and other associated metadata, and, by default,
generate the C# code for a class that can serve as a proxy for communicating with the
service. It also generates, by default, a .NET application-specific configuration file
containing the definition of the service’s endpoints. The switches, /out:Client.cs, and
/config:app.config, used in the foregoing command specify the names to be used for
the file containing the C# code, and for the configuration file. In the next few steps,
the output from the Service Metadata Tool will be used to complete the client for the
derivatives calculator.
e. Return to Visual Studio 2005.
f. Choose Debug | Stop Debugging from the Visual Studio 2005 menus to terminate
the instance of the Host console application so that the solution can be modified.
g. Select File | New | Project from Visual Studio 2005 menus to add a C# Console
Application project called, Client, to the DerivativesCalculatorSolution solution.
h. Choose Project | Add Reference from the Visual Studio 2005 menus, and add a

Page 14 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
reference to the Windows Communication Foundation’s System.ServiceModel
.NET assembly to the client project.
i. Select Project | Add Existing Item from the Visual Studio 2005 menus, and add
the files, Client.cs and app.config, in the folder,
c:\DerivativesCalculatorSolution, to the Client project. Those are the files that
should have been emitted by the Service Metadata Tool.
j. Alter the code in the Program.cs file of the Client project of the Derivatives
Calculator solution to use the class generated by the Service Metadata Tool as a
proxy for communicating with the derivatives calculator service. The code in the
Program.cs file should be: (Snippet 11)
using System;
using System.Collections.Generic;
using System.Text;

namespace Client
{
public class Program
{
public static void Main(string[] args)
{
Console.WriteLine("Press any key when the
service is ready.");
Console.ReadKey();

decimal result = 0;
using (DerivativesCalculatorProxy proxy =
new
DerivativesCalculatorProxy("CalculatorEndpoint"))
{
result = proxy.CalculateDerivative(
new string[] { "MSFT" },
new decimal[] { 3 },
new string[] { });
proxy.Close();
}
Console.WriteLine(string.Format("Result: {0}",
result));

Console.WriteLine("Press any key to exit.");

Console.ReadKey();

}
}
}
The statement,
DerivativesCalculatorProxy proxy =
new
DerivativesCalculatorProxy("CalculatorEndpoint")
creates an instance of the class generated by the Service Metadata Tool to serve as a
proxy for the derivatives calculator service. The string parameter passed to the
constructor of the class, “CalculatorEndpoint”, identifies which definition of an
endpoint in the application’s configuration file is the definition of the endpoint with
which this instance of the class is to communicate. Therefore, one must identify an

Page 15 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
endpoint definition in the configuration file accordingly.
The app.config file added to the Client project in step 8, above, should contain this
definition of an endpoint, with a specification of an address, a binding, and a contract:
<client>
<endpoint
address="http://localhost:8000/Derivatives/Calculator"

bindingConfiguration="BasicHttpBinding_IDerivativesCalcula
tor"
binding="customBinding"
contract="IDerivativesCalculator" />
</client>
k. Modify that definition so that it has the name of the endpoint definition passed to
constructor of the proxy class in the foregoing C# code, the name,
CalculatorEndpoint: (Snippet 12)
<client>
<endpoint name="CalculatorEndpoint"

address="http://localhost:8000/Derivatives/Calculator"

bindingConfiguration="BasicHttpBinding_IDerivativesCalcula
tor"
binding="customBinding"
contract="IDerivativesCalculator" />
</client>
l. In the Solution Explorer, right-click the solution and click Properties.
m. Click the Multiple startup projects radio button and set Client and Host to Start.
n. Click OK and click Debug | Start Debugging.
o. Maximize the Client console.
p. When there is activity in the console for the Host application, enter a keystroke
into the console for the Client application. The client should obtain an estimate of
the value of a derivative from the Derivatives Calculator service.
q. In Visual Studio 2005, choose Debug | Stop Debugging from the menus
2. Use a different In the preceding steps for building a client for the derivatives calculator service, the
method to code code for the client was generated using the Windows Communication Foundation’s
Windows Service Metadata Tool. They generated code consists of a version of the
Communication IDerivativesProxy interface, and the code of a proxy class for communicating with the
Clients. derivatives calculator service. The latter code as follows:
public partial class DerivativesCalculatorProxy :

System.ServiceModel.ClientBase<IDerivativesCalculator>,
IDerivativesCalculator
{

public DerivativesCalculatorProxy()
{
}

public DerivativesCalculatorProxy(string
endpointConfigurationName) :
base(endpointConfigurationName)

Page 16 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
{
}

public DerivativesCalculatorProxy(string
endpointConfigurationName,
string remoteAddress) :
base(endpointConfigurationName, remoteAddress)
{
}

public DerivativesCalculatorProxy(string
endpointConfigurationName,
System.ServiceModel.EndpointAddress remoteAddress)
:
base(endpointConfigurationName, remoteAddress)
{
}

public
DerivativesCalculatorProxy(System.ServiceModel.Binding
binding,
System.ServiceModel.EndpointAddress remoteAddress)
:
base(binding, remoteAddress)
{
}

public decimal CalculateDerivative(string[] symbols,

decimal[] parameters,
string[] functions)
{
return
base.InnerProxy.CalculateDerivative(symbols,
parameters,
functions);
}
}
Naturally, one can write such a class instead of generating it with the Service
Metadata Tool. To do so, one simply defines a class that inherits from the Windows
Communication Foundation’s ClientBase<T> generic, and which implements the
contract for the service:
[ServiceContract]
public interface IDerivativesCalculator
{
[OperationContract]
decimal CalculateDerivative(
string[] symbols,
decimal[] parameters,
string[] functions);
…
}

public partial class DerivativesCalculatorProxy :

Page 17 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
ClientBase<IDerivativesCalculator>,
IDerivativesCalculator
{
…
}
Then, in the class’s implementations of the contract, one simply delegates to the
methods of the InnerProxy property of ClientBase<T>:
public partial class DerivativesCalculatorProxy :
ClientBase<IDerivativesCalculator>,
IDerivativesCalculator
{
public decimal CalculateDerivative(string[] symbols,
decimal[] parameters,
string[] functions)
{
return
base.InnerProxy.CalculateDerivative(symbols,
parameters,
functions);
}
}
This way of writing a Windows Communication Foundation client for the derivatives
calculator service is one of the two ways of doing so. The other way of writing a client
for the service, given a definition of the IDerivativesCalculator contract, would simply
be to write,
IDerivativesCalculator proxy =
new
ChannelFactory<IDerivativesCalculator>(“EndpointName”).
CreateChannel();
proxy.CalculateDerivative(…);
Whereas the first method for writing clients yields a reusable proxy class, this second
method merely yields a proxy variable.
3. For Your The service by which the facilities of the derivatives calculator class are made
Information: Using available for use by other software entities is configured to use the Windows
the Service with a Communication Foundation’s standard BasicProfileBinding. That binding conforms
Java Client. to the WS-I Basic Profile Specification 1.1. Therefore, the service can not only be
used by clients built using the Windows Communication Foundation, but by any
clients that can consume services that comply with that specification. For instance,
one can download the tools for other platforms which, like the Windows
Communication Foundation’s Service Metadata Tool, will download the WSDL for a
service, and generate the code of a class that can be used as a proxy for the service.

Page 18 of 30
The Fundamentals of Programming the Windows Communication Foundation

Exercise 4
Hosting the Service in IIS

Scenario
Recall that IIS can be made to provide application domains for hosting Windows Communication Foundation
services. Having IIS provide hosts for Windows Communication Foundation services is beneficial for several
reasons:
• IIS is a scalable host. Its scalability features include computer processing unit (CPU) affinity and Web
gardening.
• IIS is a reliable host. Its reliability features include health management, process isolation, and application
domain isolation.
• IIS is a fault-tolerant host. If an unhandled exception occurs in a service, IIS will automatically restart it.
The security of IIS has been arduously tested, found wanting, and reinforced. While IIS is notorious for having been
the victim of a number of successful attacks in the past, it now incorporates lessons learned from that experience,
making it far more trustworthy than untried alternatives.
Only services of which all of the endpoints have bindings for communicating using HTTP can be hosted within IIS
5.1 and IIS 6, those being the versions of IIS provided for Windows XP and Windows Server 2003. IIS 7
incorporates a new facility called the Windows Activation Service for routing to hosted .NET assemblies messages
received using any transport protocol. Thus, Windows Communication Foundation service can be hosted within IIS
7 regardless of their transport protocols. Even custom transport protocols added to the Windows Communication
Foundation’s Channel Layer can be supported in IIS 7 through customizations to the Windows Activation Service.
To have IIS host a Windows Communication Foundation service, one must simply identify the service type of the
service to IIS. That is done in a file with content very similar to the contents of the .asmx file that one would use in
creating an ASP.NET Web service. For example, to have the derivatives calculator service hosted within IIS, one
would use a file containing these directives:
<%@Service Class="DerivativesCalculator.DerivativesCalculatorServiceType" %>
<%@Assembly Name="DerivativesCalculatorService" %>
The Service directive identifies the service type of the service that IIS is to host, while the Assembly directive
indicates which assembly contains that service type.
Now, by default, a file with these directives, telling IIS to host a Windows Communication Foundation service, must
have the extension, .svc. In the November CTP and earlier releases of WinFX, that default cannot modified, but it
will be possible to modify it in subsequent releases. Specifically, one will be able to specify any number of
extensions by adding the appropriate entries to the system’s web.config file, which should be in the CONFIG
subdirectory of the .NET Framework installation folder. For example, entries like these would specify that not only
the .svc extension, but also the .asmx extension should be treated as containing directives for the hosting of
Windows Communication Foundation services:
<system.web>
…
<compilation>
…
<buildProviders>
…
<add
extension=".asmx"
type="System.ServiceModel.ServiceBuildProvider, System.ServiceModel, …"
/>

Page 19 of 30
The Fundamentals of Programming the Windows Communication Foundation
<add
extension=".svc"
type="System.ServiceModel.ServiceBuildProvider, System.ServiceModel, …"
/>
</buildProviders>
…
</compilation>
…
</system.web>
Having files with the .asmx extension treated as files with directives for hosting Windows Communication
Foundation services would be useful in rewriting ASP.NET Web services as Windows Communication Foundation
services. One could rewrite the ASP.NET services as Windows Communication Foundation services and have
clients of the original services still be able to refer to those services using URI with a path containing an .asmx
extension.

Tasks Detailed Steps

1. Host the service with Up to this point, the Windows Communication Foundation service for accessing the
IIS. facilities of the derivatives calculator class has been hosted within a console
application. The steps for hosting the service within IIS begin with these steps for
creating an IIS virtual directory by which IIS will map a URI to the location of the
derivatives calculator service:
a. Click Start | Administrative Tools | Internet Information Services (IIS)
Manager from the Windows Start menu.
b. Expand the nodes of the tree control in the left-hand pane until the node named,
Default Web Site becomes visible.
c. Right-click on that node, and choose New | Virtual Directory from the context
menu that appears.
d. In the Virtual Directory Creation Wizard, enter, DerivativesCalculatorService in
the Virtual Directory alias screen.
e. Enter, c:\DerivativesCalculatorSolution\DerivativesCalculatorService as the
path on the Web Site Content Directory screen of the wizard.
f. Select the Read, Run Scripts, and Execute permissions on the wizard’s Virtual
Directory Access Permissions screen, then click on the button labeled, Next, and
follow the instructions to exit from the wizard.
The creation of the IIS virtual directory is complete. Here are the remaining steps for
having IIS host the derivatives calculator service:
g. In Visual Studio 2005, add a text file named, Service.svc, to the
DerivativesCalculatorService project.
h. Add content to that file so that it looks like this:
<%@Service
Class="DerivativesCalculator.DerivativesCalculatorServiceT
ype" %>
<%@Assembly Name="DerivativesCalculatorService" %>
Those directives tell IIS to host the Windows Communication Foundation service type,
DerivativesCalculator.DerivativesCalculatorServiceType, that is in the assembly,
DerivativesCalculatorService. IIS will be looking for that assembly in the bin
subdirectory of the folder in which the file referring to the assembly is located.
Therefore, it is necessary to ensure that the asssemly is located there. These next two
steps will accomplish that task:
i. Select the DerivativesCalculatorService project of
DerivativesCalculatorSolution in the Visual Studio 2005 Solution Explorer.
Choose Project | DerivativesCalculatorService Properties from the Visual

Page 20 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
Studio menus.
j. Select the Build tab, and set the value of the Output path property to refer to the
bin subdirectory of the project directory.
k. Select Build | Build Solution from the Visual Studio 2005 menus.
The remaining two steps are for configuring the service. In hosting the service within
the Host console application, the configuration for the service was incorporated into
the configuration file for that application. Now that the service is to be hosted within
IIS, the configuration information must be a configuration file named Web.config in
the same directory as the file with the directives telling IIS to host the service.
l. Add an Web Configuration File named, Web.config, to the
DerivativesCalculatorService project in the derivatives calculator solution.
m. Modify the contents of that file in this way, before saving the file: (Snippet 14)
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.serviceModel>
<services>
<service type=
"DerivativesCalculatorService.DerivativesCalculatorService
Type,DerivativesCalculatorService">
<endpoint
address=""
binding="basicHttpBinding"
contract=
"DerivativesCalculatorService.IDerivativesCalculator,Deriv
ativesCalculatorService"
/>
</service>
</services>
</system.serviceModel>
</configuration>
There is just one difference between this configuration information and the
information that was in the application configuration file of the Host console
application: the value provided for the address of the service’s endpoint is an empty
string. The reason is that the address of any endpoint of a service hosted within IIS is
the URI of the file containing the directives telling IIS to host the service.
The work required for hosting the derivatives calculator service in IIS is complete.
The availability of the service can be confirmed in this way:
n. Click File | Save All.
o. Choose Run from the Windows Start menu, and enter,
http://localhost/DerivativesCalculatorService/Service.svc
Internet Explorer should open and display a page similar to the one displayed before.
Now that the service is available, the client can be modified to use the derivatives
calculator service hosted within IIS.
p. Modify the app.config file in the Client project of the derivatives calculator
solution, to refer to the address of the endpoint hosted within IIS by changing this
entry in the file,
address="http://localhost:8000/Derivatives/Calculator"
to this: (Snippet 15)
address="http://localhost/DerivativesCalculatorService/Ser
vice.svc"

Page 21 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
q. Choose Build | Build Solution from the Visual Studio 2005 menus.
r. Right-click on the Client entry in the Visual Studio 2005 Solution Explorer, and
select, Debug | Start New Instance from the context menu.
s. When the console application window of the host appears, enter a keystroke into
the console. The client obtains an estimate of the value of a derivative from the
Derivatives Calculator service hosted in IIS.
t. Close the Client executable.

Page 22 of 30
The Fundamentals of Programming the Windows Communication Foundation

Exercise 5
Securing the Service

Scenario
The only provision that the WS-I Basic Profile 1.1 makes for securing communications is the use of the Secure
Hypertext Transfer Protocol (HTTPS). Since that protocol was never applied to the Derivatives Calculator service,
one should not expect that transmissions to and from the service are being kept confidential at this point.

Tasks Detailed Steps

1. Show that The following steps will prove that the transmissions are not being kept confidential.
transmissions are not They will also demonstrate just one of the Windows Communications Foundation’s
confidential. many features for administering services: its facility for logging messages.
a. Provide an empty folder to which the Windows Communication Foundation can
log messages. In the following steps, that folder will be assumed to be the folder,
c:\logs.
b. Modify the Web.config file of the DerivativesCalculatorService project to look
like the code below, which configures a standard .NET diagnostics trace listener to
listen for trace information emanating from the Windows Communication
Foundation’s message logging facility, System.ServiceModel.MessageLogging.
The configuration also turns that logging facility on with the diagnostics element
within the System.ServiceModel element. (Snippet 16)
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.diagnostics>
<sources>
<source
name="System.ServiceModel.MessageLogging"
switchValue="Verbose">
<listeners>
<add
name="xml"

type="System.Diagnostics.XmlWriterTraceListener"
initializeData="c:\logs\message.log"
/>
</listeners>
</source>
</sources>
<trace autoflush="true" />
</system.diagnostics>
<system.serviceModel>
<diagnostics>
<messageLogging logEntireMessage="true"
maxMessagesToLog="300"
logMessagesAtServiceLevel="false"
logMalformedMessages="true"

logMessagesAtTransportLevel="true" />
</diagnostics>
<services>

Page 23 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
<service type=
"DerivativesCalculator.DerivativesCalculatorServiceType,De
rivativesCalculatorService">
<endpoint
address=""
binding="basicHttpBinding"
contract=
"DerivativesCalculator.IDerivativesCalculator,DerivativesC
alculatorService"
/>
</service>
</services>
</system.serviceModel>
</configuration>
c. Build the solution.
d. Start an instance of the Client executable, and enter a keystroke into the console
for the Client application. The client should obtain an estimate of the value of a
derivative from the Derivatives Calculator service hosted in IIS.
e. Close the Client executable.
f. Open the file, c:\logs\Message.log, in Notepad. Search for the string, MSFT,
which, as should be apparent from above, is a stock symbol that the client
transmits to the server in its request to calculate the value of a derivative. That
string will be found in the file, because communications with the derivatives
calculator service are not being kept confidential.
g. The Windows Communication Foundation provides at least two principal ways of
remedying that problem. One is to secure the transmissions by using a secure
transport protocol, substituting HTTPS for HTTP, for example. The other is to
encrypt the messages before transporting them, as provided for by the WS-Security
protocol, for example.
2. Secure the service The HTTPS protocol uses the Secure Socket Layer/Transport Layer Security
with a Secure (SSL/TLS) protocol. Instructions for configuring the SSL/TLS protocol on IIS are
Transport Protocol. available at
http://www.microsoft.com/smallbusiness/support/articles/sec_IIS_6_0.mspx#EDAA.
Assuming that the SSL/TLS protocol has been configured on the IIS hosting the
derivatives calculator service, then secure transmissions between the client and the
service via the HTTPS protocol can be accomplished simply by replacing the contents
of the Web.config file in the DerivativesCalculatorService project of the derivatives
calculator solution, with the configuration listed here:
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.serviceModel>
<services>
<service type=
"DerivativesCalculatorService.DerivativesCalculatorService
Type,DerivativesCalculatorService">
<endpoint
address=""
binding="basicHttpBinding"

bindingConfiguration="SecureBasicHttpBinding"
contract=
"DerivativesCalculatorService.IDerivativesCalculator,Deriv

Page 24 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
ativesCalculatorService"
/>
</service>
</services>
<bindings>
<basicHttpBinding>
<binding name="SecureBasicHttpBinding">
<security mode="Transport">
<transport
clientCredentialType="None"/>
</security>
</binding>
</basicHttpBinding>
</bindings>
</system.serviceModel>
</configuration>
and by replacing the contents of the app.config file the Client project with the
configuration listed here:
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.serviceModel>
<client>
<endpoint
name="CalculatorEndpoint"

address="https://localhost/DerivativesCalculatorService/
Service.svc"
bindingConfiguration="SecureBasicHttpBinding"
binding="basicHttpBinding"
contract="IDerivativesCalculator" />
</client>
<bindings>
<basicHttpBinding>
<binding name="SecureBasicHttpBinding">
<security mode="Transport">
<transport clientCredentialType="None"/>
</security>
</binding>
</basicHttpBinding>
</bindings>
</system.serviceModel>
</configuration>
Both configurations incorporate these two lines:
binding="basicHttpBinding"
bindingConfiguration="SecureBasicHttpBinding"
The first line should be familiar from the foregoing: it simply says that the standard
Windows Communication Foundation BasicHttpBinding is the binding for the
derivatives calculator endpoint. The second line is new. It says that the properties of
the standard BasicHttpBinding are to be modified somewhat from their default values,
and that the set of modifications are labeled SecureBasicHttpBinding. Elsewhere
within the System.ServiceModel element of the configuration, there is this sub-
element:
<bindings>

Page 25 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
<basicHttpBinding>
<binding name="SecureBasicHttpBinding">
<security mode="Transport">
<transport clientCredentialType="None"/>
</security>
</binding>
</basicHttpBinding>
</bindings>
That sub-element could contain any number of different sets of modifications to the
default settings of any number of different standard bindings. In this case, it contains
just one set of modifications, which is the set with the label, SecureBasicHttpBinding,
the set to which the line,
bindingConfiguration="SecureBasicHttpBinding"
referred. The modifications to the default settings specify that transmissions are to be
secured by the transport protocol. Note that the only modifications that the Windows
Communication provides for the standard BasicHttpBinding are modifications that
are permitted by the WS-I Basic Profile 1.1 specification.
The only other important change in the configurations is this alteration, in listing 2.8,
to the client configuration:
address="https://localhost/DerivativesCalculatorService/Se
rvice.svc"
It uses the scheme, https, in the URI for the service, thereby directing the request via
IIS’ SSL/TLS socket.
3. Encrypt message WS-Security is a standard protocol for ensuring the confidentiality of communications
before transporting through the encryption of messages. Although the WS-Security protocol is widely
them. accepted and despite their being several implementations, it is, nonetheless, not
included in the WS-I Basic Profile Specification 1.1, which was meant to ensure
interoperability by incorporating only the most fundamental protocols. Yet, while the
use of a transport security protocol like HTTPS to assure confidentiality tends to
provide better performance, the use of a protocol like WS-Security that works by
encrypting the messages before transporting them, offers more flexibility. For
example, whereas the use of HTTPS presupposes having a Web server like IIS that
supports HTTPS, the Windows Communication makes it very simple to apply the WS-
Security protocol in scenarios with or without IIS.
a. Modify the app.config file of the Host project in the in the derivatives calculator
solution to look like this: (Snippet 18)
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<appSettings>
<add key="HTTPBaseAddress"
value="https://localhost:8000/Derivatives/"/>
<add key="TCPBaseAddress"
value="net.tcp://localhost:8010/Derivatives/"/>
</appSettings>
<system.diagnostics>
<sources>
<source
name="System.ServiceModel.MessageLogging"
switchValue="Verbose">
<listeners>
<add
name="xml"

Page 26 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps

type="System.Diagnostics.XmlWriterTraceListener"

initializeData="c:\logs\hostmessage.log" />
</listeners>
</source>
</sources>
<trace autoflush="true" />
</system.diagnostics>
<system.serviceModel>
<diagnostics>
<messageLogging logEntireMessage="true"
maxMessagesToLog="300"
logMessagesAtServiceLevel="false"
logMalformedMessages="true"

logMessagesAtTransportLevel="true" />
</diagnostics>
<services>
<service type=
"DerivativesCalculator.DerivativesCalculatorServiceType,De
rivativesCalculatorService">
<endpoint
address="Calculator"
binding="wsHttpBinding"
contract=
"DerivativesCalculator.IDerivativesCalculator,DerivativesC
alculatorService"
/>
</service>
</services>
</system.serviceModel>
</configuration>
This change to the configuration file of the .NET application for hosting the
derivatives calculator service substitutes the standard binding, WSHttpBinding, for the
standard binding, BasicHttpBinding, that had been used before. WSHttpBinding is a
standard binding that, by default, uses the WS-Security protocol.
The new configuration also has the service log the messages that it receives.
Specifically, the service is to log the messages to the file, message.log, in the folder,
c:\logs. Change that setting to point to a different file and folder if necessary.
b. You’ll notice the blue line under the <diagnostics> tag. This indicates that a
diagnostics section in this part of the config is not recognized as a legal location.
Highlight the entire area from the beginning of <diagnostics> to the end of
</diagnostics>, cut it, and paste it just before the <services> tag, as seen in the
code above.
c. Ensure that, whatever file is referred to in the configuration for logging the
messages, the file does not exist, or has been deleted. If the configuration is
pointing to the C:\logs\message.log file, change that setting to point to the file
C:\logs\HostMessage.log. Having a fresh log will serve to highlight the effects of
the new configuration clearly.
d. Change the app.config file in the Client project to look like this, with a
description of the derivatives calculator endpoint matching the description in the
server’s configuration. (Snippet 19)

Page 27 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.serviceModel>
<client>
<endpoint
name="SelfHostedEndpoint"

address="http://localhost:8000/Derivatives/Calculator"
binding="wsHttpBinding" contract="IDerivativesCalculator"
/>
</client>
</system.serviceModel>
</configuration>
e. The name of the endpoint is still CalculatorEndpoint, so we need to change that.
Change the name of the endpoint in app.config from SelfHostedEndpoint to
CalculatorEndpoint.
f. Click Debug | Start Debugging.
g. When there is activity in the console for the Host application, enter a keystroke
into the console for the Client application. The client should again obtain an
estimate of the value of a derivative from the Derivatives Calculator service.
h. Stop debugging.
i. Open the file, c:\logs\HostMessage.log, in Notepad. Search for the string,
MSFT, which, as mentioned before, is a stock symbol that the client transmits to
the server in its request to calculate the value of a derivative. That string will not
be found in the file, because now the messages exchanged with the derivatives
calculator service are being kept confidential through encryption.
j. Modify the CalculateDerivative method of the
DerivativesCalculatorServiceType in the DerivativesCalculatorService project
to look like this: (Snippet 20)
decimal IDerivativesCalculator.CalculateDerivative(
string[] symbols,
decimal[] parameters,
string[] functions)
{
Console.WriteLine(
"Message received from {0}.",
System.ServiceModel.
OperationContext.
Current.ServiceSecurityContext.
WindowsIdentity.Name.ToString());
return new Calculator().CalculateDerivative(
symbols, parameters, functions);
}
k. Rebuild the solution, and re-execute steps f, g, and h, above.
This time, the console application window of the Host application should show the
identity of the user of the client application. That is possible because, by default, the
WSHttpBinding uses the Windows identity of the user of the client application to
authenticate a client to a service. The Windows Communication Foundation Service
Model’s OperationContext class provides static properties for retrieving information
about the context in which a method of a service is being invoked, and, in the new
code for the CalculateDerivative method, it is the information about the identity of the
client that is retrieved and displayed.

Page 28 of 30
The Fundamentals of Programming the Windows Communication Foundation
Tasks Detailed Steps
The Windows Communication Foundation’s OperationContext class may seem
familiar to programmers used to Microsoft Transaction Server, COM+, and
Enterprise Services programming. The OperationContext class is similar to the
ContextUtil class of those earlier programming interfaces.

Page 29 of 30
The Fundamentals of Programming the Windows Communication Foundation

Exercise 6
Debugging

Scenario
The Windows Communication Foundation’s facility for logging messages has already been demonstrated, above.
That is a powerful tool for diagnosing problems with services in production, and should be welcomed by anyone
who has attempted the challenging task of logging messages to or from ASP.NET Web Services. Other potent
instruments for administering Windows Communication Foundation solutions in production are covered in a later
chapter.
To diagnose problems with Windows Communication Foundation solutions in development, the most important tool
is the Visual Studio 2005 debugger. Generally, one can simply set breakpoints in the code for a client or service,
and start debugging one’s code.
In the case of a service, when one starts debugging it within Visual Studio 2005, Visual Studio automatically
attaches its debugger to the host process. When the service is being hosted within IIS, one must attach the Visual
Studio 2005 debugger to the host process manually. Doing so requires two steps.
The first step is to cause IIS to actually have the service loaded into an application domain. That can be done either
by having a client invoke the service, or by browsing to the location of the service’s .svc file to view the service’s
help page.
The remaining step is to actually attach the Visual Studio debugger to the host process. One begins doing that by
choosing Debug | Attach to Process from the Visual Studio menus. Then, on Windows Server 2003, one selects
w3wp.exe from the list in the Attach to Process dialog, and on Windows XP, one selects aspnet_wp.exe, those being
the processes in which IIS hosts Windows Communication Foundation services. Finally, one clicks on the Attach
button. Then, any breakpoint set in the code for the service can provide a starting point for stepping through it.
Evidently, while it is not especially difficult to debug services hosted in IIS, it is a little more challenging.
Therefore, it is recommended to follow the approach shown in this chapter, of first hosting the service within one’s
own .NET application, and thoroughly debugging it within that process, before proceeding to host the service within
IIS.

Conclusion
Using the Windows Communication Foundation, you can quickly write powerful distributed applications and easily
adapt code to new scenarios. For instance, as we just saw, you can host the same service within a .NET console
application or within IIS without modifying the code for the service at all. You can also easily change how a client
and service communicate. For instance, in this lab you made the communication between them confidential. With
the Windows Communication Foundation, you can rapidly build and adapt powerful connected applications to your
business scenario.

Page 30 of 30