On the File menu, point to New, and then click Project to open the New Project dialog box.

Select the Visual C++ Projects folder, and then click the ASP.NET Web Service icon.

In the Name box, type TempConvert3 and then click OK.

The project template automatically provides the necessary files and references to support an XML Web service.

Tip
In Solution Explorer see the ReadMe.txt file that describes the projects and files generated.

Double-click the Component Designer's design surface to view the code for this file, TempConvert3Class.h.

The methods of the TempConvert3Class class provide the implementation of the XML Web service. TempConvert3Class inherits from the System::Web::Services::WebService base class. Locate the class declaration:

public ref class TempConvert3Class :
    public System::Web::Services::WebService

Insert the following code before that declaration:

[System::Web::Services::WebServiceAttribute(
    Namespace="http://Walkthrough/XmlWebServices/",
    Description="A temperature conversion XML Web Service.")]

Attaching the System::Web::Services::WebServiceAttribute attribute to this class makes it possible for you to include additional information about the XML Web service, such as specifying a namespace and a description. The description property of this attribute is included in the Service help page. For more information, see WebServiceAttribute.

You will add a public method to this class and expose that method as part of the XML Web service. Locate the sample HelloWorld method:

public:
        [System::Web::Services::WebMethod]
        String ^HelloWorld();

        // TODO: Add the methods of your Web Service here

Replace that method with the following:

public:
   [System::Web::Services::WebMethod(
      Description="Converts temperatures from F to C.")]
      double ConvertTemperature(double dFahrenheit);

Attaching the System::Web::Services::WebMethod attribute to this method indicates that you want the method exposed as part of the XML Web service. The description property of this attribute is included in the Service help page and the Service method help page. For more information, see WebMethodAttribute.

In Solution Explorer, locate TempConvert3Class.cpp in the Source Files folder of the TempConvert3 project and open this file for editing.

Locate and replace the contents of the TempConvert3 namespace with the following:

namespace TempConvert3
{
    double TempConvert3Class::ConvertTemperature(double dFahrenheit)
    {
        return ((dFahrenheit - 32) * 5) / 9;
    }
};

Save the solution.

On the Build menu, click Build Solution.

On the Debug menu, select New Breakpoint, and then select Break at Function.

From the New Breakpoint dialog box, type TempConvert3::TempConvert3Class::ConvertTemperature next to Function and click OK to place a breakpoint on the ConvertTemperature method declaration.

On the Debug menu, click Start Debugging.

This command instructs Visual Studio to run the XML Web service as it would normally. Visual Studio builds the project and deploys it to the designated development server. Upon completion, the default browser displays the .asmx file from the deployment server.

When you open an .asmx file in a browser, the XML Web service returns a Service helper page that provides information about the XML Web service. Clicking the Service Description link returns an XML document that contains the formal service description of the XML Web service. For more information, see XML Web Service Description.

On the TempConvert3Class Web Service page, click the ConvertTemperature link.

In the dFahrenheit box, type the number 212, and then click the Invoke button.

When processing reaches the ConvertTemperature function, processing stops. The Visual Studio debugger highlights the line containing the breakpoint and while halted, you can perform a variety of tasks. For more information, see Debugger and Language Overview and Viewing Data in the Debugger.

On the Debug menu, click Continue to continue processing.

The XML Web service responds by returning the converted value in an XML document resembling the following:

<?xml version="1.0" encoding="utf-8" ?>
<double xmlns="http://Walkthrough/XmlWebServices/">100</double>

To stop running the XML Web service and return to the Code Editor, on the Debug menu, click Stop Debugging.

On the Debug menu, click Delete All Breakpoints.

On the File menu, point to New and then click Project.

From the Project types pane, expand the Other Project Types node and select Setup and Deployment. From the Templates pane, click Web Setup Project.

In the Name box, type TempConvert3WebSetup.

From the Solution drop down list, select Add to Solution, and then click OK.

Note
By default, the installer uses the deployment project name when creating the virtual directory on your deployment server.

In the left pane of the File System (TempConvert3WebSetup) tab, select Web Application Folder. For more information, see File System Editor.

In Solution Explorer, right-click TempConvert3WebSetup, point to Add, and then click Project Output.

In the Add Project Output Group dialog box, select Content Files. For more information, see How to: Add and Remove Project Outputs in the File System Editor.

• The Content Files group consists of the following files for the XML Web service: TempConvert3.asmx, Global.asax, and Web.config. For more information, see Deploying XML Web Services in Managed Code.

Click OK.

In the left pane of the File System (TempConvert3WebSetup) tab, expand Web Application Folder and locate the folder labeled bin.

Right-click the bin folder, point to Add, and then click Project Output.

In the Add Project Output Group dialog box, select Primary output and Debug Symbols. For more information, see How to: Add and Remove Project Outputs in the File System Editor.

• The Primary output group consists of the project DLL, TempConvert3.dll, and its dependencies.

• The Debug Symbols group consists of the project PDB file, TempConvert3.pdb.

Click OK.

In Solution Explorer, right-click the deployment project, and then on the shortcut menu, click Build.

This creates a Windows Installer file in the local project directory. Execute this file on a Web server to install this XML Web service.