On the File menu, choose New Web Site.

In the New Web Site dialog box, select the ASP.NET Web Service icon.

Enter the address of the Web server on which you will develop the XML Web service and specify TempConvert1 as the directory name, such as "http://MyServer/TempConvert1". By default, the project uses your local computer, "http://localhost".

Note
For some project types, the Name textbox is unavailable because specifying the location sets the project name instead. For example, Web applications and XML Web services are located on a Web server and derive their name from the virtual directory specified on that server.

Note

You develop XML Web services on a development server. By default, the development server is your local machine. Typically, you develop and build the project on a development server, and then you deploy it to another server (the deployment server) that will host the XML Web service using a deployment project. However, if you are developing directly on the server that will host the XML Web service, the development server and deployment server are the same.

Click OK to create the project.

In the Service.vb code file, locate the code for the Service class declaration. Replace the System.Web.Services.WebService attribute code with the following code (shown in bold) before the class declaration:

<System.Web.Services.WebService( _
   Namespace:="http://Walkthrough/XmlWebServices/", _
   Description:="A temperature conversion service.")> _
Public Class Service

[System.Web.Services.WebService(
   Namespace="http://Walkthrough/XmlWebServices/",
   Description="A temperature conversion service.")]
public class Service : System.Web.Services.WebService

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

In the Service class, add the following code to declare the ConvertTemperature function:

<WebMethod(Description:="This method converts a temperature in " & _
       "degrees Fahrenheit to a temperature in degrees Celsius.")> _
Public Function ConvertTemperature(ByVal dFahrenheit As Double) _
                                   As Double
    Return ((dFahrenheit - 32) * 5) / 9
End Function

[WebMethod(Description="This method converts a temperature in " +
       "degrees Fahrenheit to a temperature in degrees Celsius.")]
public double ConvertTemperature(double dFahrenheit)
{
   return ((dFahrenheit - 32) * 5) / 9;
} 

Attaching the WebMethod attribute to a Public method exposes that method 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 How to: Use the WebMethod Attribute.

Right-click Service.asmx in Solution Explorer and then click Set as Start Page on the shortcut menu.

Save the solution.

On the Debug menu, choose New Breakpoint, then Break At Function.

On the Function tab, type ConvertTemperature in the Function box and click OK to add a breakpoint on the ConvertTemperature method declaration.

On the Debug menu, click Start, then click Ok in the Debugging Not Enabled window to start debugging.

This command instructs Visual Studio to run the XML Web service in the debugger. 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. The Service Description link takes you to an XML document that contains the formal service description of the XML Web service. For more information, see XML Web Service Description.

On the Service helper 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; while it is halted, you can perform a variety of tasks. For more information, see Debugger Roadmap 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 Add, and then click New Project.

Select the Other node, then the Setup and Deployment Projects node, and then click Web Setup Project.

In the Name box, type TempConvert1WebSetup, 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 Editor, select Web Application Folder. For more information, see File System Editor.

In Solution Explorer, right-click TempConvert1WebSetup, 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: Service1.asmx, Global.asax, and Web.config. For more information, see How to: Deploy XML Web Services in Managed Code.

Click OK.

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

This creates a Windows Installer file in the local project directory. Executing this file installs the Web application.

In Solution Explorer, select the TempConvert1 project.

On the Project menu, click Copy Web Site.

Click the icon next to the Connect To dropdown box to open the Open Web Site dialog box. Browse to the location to which you want to copy the project.

In the Source Web Site pane, select the files to copy and move them to the Remote Web Site pane by clicking the right-arrow icon. .

Click Copy Web Site to copy the Web site.