Добавил:
Опубликованный материал нарушает ваши авторские права? Сообщите нам.
Вуз: Предмет: Файл:
Microsoft C# Professional Projects - Premier Press.pdf
Скачиваний:
177
Добавлен:
24.05.2014
Размер:
14.65 Mб
Скачать

DEVELOPING WEB SERVICES

Chapter 29

645

 

 

 

 

Creating the SearchAll() Web Method

Creating a Web service involves coding for the Web methods in the Web service. In this case, you need to create a Web method that returns information about all the books published at Deepthoughts Publications. Before creating the Web method, add a short description about the Web method.

[WebMethod(Description=”This method searches for the details of all books published

by Deepthoughts Publications”)]

Now add the code for the Web method. The code for the Web method is as displayed:

[WebMethod(Description=”This method searches for the details of all books published by Deepthoughts Publications”)]

public DataSet SearchALL()

{

string SelStr;

SelStr = “Select * from DTCatalog”;

SqlCommand SelCom;

SelCom = new SqlCommand(SelStr, sqlConnection1); sqlDataAdapter1.SelectCommand = SelCom; sqlConnection1.Open(); sqlDataAdapter1.SelectCommand.ExecuteNonQuery(); sqlDataAdapter1.Fill(dsDetails1,”Details”); sqlConnection1.Close();

return dsDetails1;

}

The preceding code declares a string variable with the name SelStr. Next, the code initializes the SelStr variable to a SQL statement that retrieves all the records from the DTCatalog table. Next, an instance of the SqlCommand class is created with the name SelCom. The SqlCommand class is present in the System.Data.SqlClient namespace. The SqlCommand class is used to represent a SQL statement that is executed against a SQL server database. You can derive a class from a SqlCommand class.

After declaring the SelCom instance, you can initialize it. In the constructor of the SqlCommand class, you need to pass two parameters, SelStr and sqlConnection1. Because the SqlCommand class represents all the SQL statements executed against a SQL ser ver database, you need to specify the SQL statement by passing it as a

646 Project 5 CREATING A WEB PORTAL FOR A BOOKSTORE

parameter to the constructor. In addition, you need to specify the sqlConnection object for executing the SQL command. This object is passed as a parameter to the constructor of the SqlCommand class.

Next, the SelectCommand property of the SqlDataAdapter class is used to select the records stored in the SelCom object.The SqlDataAdapter class is present in the System.Data.SqlClient namespace and represents the SQL commands used to modify the SQL ser ver database.

Then, the Open() method of the SqlConnection class is used to establish a connection with the DTDB database. When a connection with the DTDB database is established, the records in the DTCatalog table are retrieved and stored in the dsDetails1 dataset. To do this, the ExecuteNonQuery() method of the SqlCommand class is executed to return the records that are affected by the SQL command stored in the SelStr variable. In this case, all the records in the DTCatalog table are returned by the ExecuteNonQuery() method. The records returned are then stored in the dataset by using the Fill() method of the DbDataAdapter class.

Once the records are retrieved, you can close the connection to the DTDB database by using the Close() method of the SqlConnection class. Finally, the dataset, dsDetails1, is returned when the SearchAll() method is called by a Web service client application. To return the dataset, you use the return keyword.

After creating the Web method, you can test the Web method by pressing the F5 key. The Service1.asmx page is displayed as shown in Figure 29-3.

FIGURE 29-3 The Service1.asmx page

DEVELOPING WEB SERVICES

Chapter 29

647

 

 

 

 

The Service1.asmx page contains a link to the SearchAll() method. Click on the link to view the Service1.asmx page for the SearchAll() method. This page contains an Invoke button. When the user clicks on the Invoke button, the SearchAll() method is executed and the results are displayed as shown in Figure 29-4.

FIGURE 29-4 The results returned by the SearchAll() method

Creating the SrchISBN() Web Method

You can now create a Web method that returns the records from the DTCatalog table with the ISBN number that is passed as a parameter to the Web method. First, write a description for the Web method.

[WebMethod(Description=”This method searches for the details of the book based on

the “ + “ ISBN Number of the book”)]

After writing the description, you need to write the code for the Web method SrchISBN(). The code for the Web method is as follows:

[WebMethod(Description=”This method searches for the details of the book based on the “ + “ ISBN Number of the book”)]

public DataSet SrchISBN(string ISBN)

{

string SelStr;

648

Project 5

 

CREATING A WEB PORTAL FOR A BOOKSTORE

 

 

 

 

 

 

SelStr = “Select * from DTCatalog where ISBNNo = @ISB”;

 

 

SqlCommand SelCom;

 

 

 

 

 

 

SelCom = new SqlCommand(SelStr, sqlConnection1);

 

 

sqlDataAdapter1.SelectCommand = SelCom;

 

 

 

sqlDataAdapter1.SelectCommand.Parameters.Add(“@ISB”,SqlDbType.Char, 10)

 

 

 

.Value = ISBN;

 

 

 

 

 

 

sqlConnection1.Open();

 

 

 

 

 

 

sqlDataAdapter1.SelectCommand.ExecuteNonQuery();

 

 

sqlDataAdapter1.Fill(dsDetails1,”Details”);

 

 

sqlConnection1.Close();

 

 

 

Y

 

 

return dsDetails1;

 

 

 

 

}

 

 

 

 

 

 

 

 

 

 

L

 

 

 

 

 

 

 

The preceding code declares a WebFmethod, SrchISBN(), which accepts a string

 

type parameter named ISBN. In the method declaration statement, you also spec-

 

ify the return type of the Web method. Because the SrchISBN() Web method

 

 

 

 

 

M

 

 

 

 

 

A

 

 

 

 

 

E

 

 

 

 

 

T

 

 

 

returns the records with the specified ISBN number, the return type of the

SrchISBN() Web method is Dataset.

Next, a SQL statement that retrieves the record with the specified ISBN number is created and stored in the string type variable SelStr. Notice that the parameter specifying the ISBN number is preceded with @ in the SQL statement. This is the syntax for writing SQL queries in Visual Studio .NET.

After the SQL statement is created, the Add() method of the SqlParameterCol-

lection class is used to add SqlParameter to the SqlParameterCollection object.

The SqlParameterCollection object is used to store the parameters associated with the SQL command in the SqlParameterCollection object. Next, the Value property is used to assign a value to the parameter. In this case, the value assigned to the @ISB parameter is the ISBN number, which is passed to the SrchISBN() Web method.

After specifying a parameter, you can create a connection to the DTDB database. To do this, you use the Open() method. Then, the records affected are retrieved and stored in the dsDetails1 dataset. In this case, the records affected are the ones that match the ISBN number sent as the parameter. After storing the records, close the SQL connection by using the Close() method. The dataset is then returned by using the return keyword.

After creating the Web method, you can test the Web service. On the Service1.asmx page for the SrchISBN() Web method, specify the parameter and

Team-Fly®

DEVELOPING WEB SERVICES

Chapter 29

649

 

 

 

 

click on the Invoke button. Figure 29-5 shows the Service1.asmx page for the

SrchISBN() Web method.

FIGURE 29-5 The Service1.asmx page for the SrchISBN() method

After clicking on the Invoke button, the Web method is executed and the results are returned as shown in Figure 29-6.

FIGURE 29-6 The results returned by the SrchISBN() method