After creating the Web service, you need to add Web methods to the Web service. The code behind the Web service is written in the Service1.asmx.cs file. To access the Service1.asmx.cs file, press the F7 key or double-click the Service1.asmx file.

As you can see in the Service1.asmx.cs file, Visual Studio .NET generates a default code for your Web service. The following section discusses the default code created by Visual Studio .NET.

The Default Code Generated for a Web Service

Creating a Web service includes writing the code for Web methods in a Web service. However, before you add Web methods to the Web service, Visual Studio

.NET generates a default code as shown:

using System;

using System.Collections; using System.ComponentModel; using System.Data;

using System.Diagnostics; using System.Web;

using System.Web.Services;

namespace SampleWebService

{

public class Service1 : System.Web.Services.WebService

{

public Service1()

{

InitializeComponent();

}

//WEB SERVICE EXAMPLE

//The HelloWorld() example service returns the string Hello World

//To build, uncomment the following lines then save and build the project

//To test this web service, press F5

//[WebMethod]

//public string HelloWorld()

As you can see in Figure 28-6, the Service1.asmx page contains the SOAP message used to send a request for a Web service. In addition, the Service1.asmx page contains the response of the request for the Web service. The response for the SampleWebService Web service is in the form of a SOAP message

The Service1.asmx page contains an Invoke button that you can click to test the Web service. When you click on the Invoke button, the Hello World Web service is displayed, as shown in Figure 28-7.

FIGURE 28-7 The Hello World Web service

Having seen a sample Web service, you can now continue with the procedure for creating the SampleWebService Web service.

Creating a Web Method in the

SampleWebService Web Service

Until now, I have not specified the task that the Web method in the SampleWebService Web service would perform. You can create a Web method that returns the day of the week on which a date falls. For example, if January 1, 2002 was Tuesday, the value returned by the Web method will be 2.

636 Project 5 CREATING A WEB PORTAL FOR A BOOKSTORE

When you create a Web service, it is a good practice to specify a summary of the Web service. This will help any user who tries to locate a similar Web service. To add a summary to your Web service, add the following line in the beginning of your Web service.

[WebService(Namespace=”http://WebServices/SampleWebService”, Description=”This

service retrieves the day of the week on which a date falls.”)]

The preceding statement includes information about the Web service that you create.This information includes the URL that you can use to access the Web service and a short description of the task performed by the Web service.

After providing the information about the Web service, write the code for the Web method required to perform the specified task. In this case, the task performed by the Web method is to return the day of the week on which a specified date falls.Therefore, you need to pass the date as a parameter to the Web method.

Similar to writing a description for the Web service, you can write a short description for the Web method that you declare in the Web service. To write a description for the Web method, add the following code to the Web service.

[WebMethod(Description=”This method returns the day of the week in integer format. It expects a date in mm/dd/yyyy format and returns 8 if the value specified is invalid.”)]

After adding a description of the Web method to the code, write the actual code for the Web method. The code for the Web method is as follows:

[WebMethod(Description=”This method returns the day of the week in integer format. It expects a date in mm/dd/yyyy format and returns 8 if the value specified is invalid.”)]

public int GetDay(DateTime dt)

{

System.DayOfWeek dw; dw=dt.DayOfWeek; switch(dw.ToString())

{

case “Sunday”:

return 0;

}

}

The preceding code declares a Web method with the name GetDay(). The GetDay() method takes a parameter dt of the struct DateTime. The date for which you want to retrieve the day is passed as a parameter dt to the GetDay() method. In addition, the GetDay() method returns an integer type value that stores the day on which the specified date falls.

Inside the declaration of the method, the code creates a variable, dw, of the enum DayOfWeek. This enumeration is present in the System namespace and is used to specify a day of the week. Next, the code initializes the dw variable to the day for the value passed as a parameter to the GetDay() method.

Then, the switch case statements are used to return an integer value for the day stored in the dw variable. To do this, the value stored in the dw variable is checked using the switch case statements. However, to check for the value stored in the dw variable, you first need to convert this value to a string type value. To do this, you can use the ToString() method.

Once you have written the code for the Web method, your Web service is ready to be tested. The following section discusses the procedure for testing a Web service.