C#操作webservice(经典入门教程及实例)

Web Service基本概念

Web Service也叫XML Web Service WebService是一种可以接收从Internet或者Intranet上的其它系统中传递过来的请求，轻量级的独立的通讯技术。是:通过SOAP在Web上提供的软件（服务），使用WSDL文件进行（说明），并通过（UDDI）进行注册。

XML：(Extensible Markup Language)扩展型可标记语言。面向短期的临时数据处理、面向万维网络，是Soap的基础。

Soap：(Simple Object Access Protocol)简单对象存取协议。是XML

Web Service 的通信协议。当用户通过UDDI找到你的WSDL描述文档后，他通过可以SOAP调用你建立的Web服务中的一个或多个操作。SOAP是XML文档形式的调用方法的规范，它可以支持不同的底层接口，像HTTP(S)或者SMTP。

WSDL：(Web Services Description Language) WSDL 文件是一个

XML 文档，用于说明一组 SOAP 消息以及如何交换这些消息。大多数情况下由软件自动生成和使用。

UDDI (Universal Description, Discovery, and Integration) 是一个主要针对Web服务供应商和使用者的新项目。在用户能够调用Web服务之前，必须确定这个服务内包含哪些商务方法，找到被调用的接口定义，还要在服务端来编制软件，UDDI是一种根据描述文档来引导系统查找相应服务的机制。UDDI利用SOAP消息机制（标准的

XML/HTTP）来发布，编辑，浏览以及查找注册信息。它采用XML格式来封装各种不同类型的数据，并且发送到注册中心或者由注册中心来返回需要的数据。

概念补充：

http soap关系

http:是一个客户端和服务器端请求和应答的标准（TCP）。http协议其目的是为了提供一种发布和接收htttp页面的方法

一http协议的客户端与服务器的交互：由HTTP客户端发起一个请求，建立一个到服务器指定端口（默认是80端口）的TCP连接。HTTP服务器则在那个端口监听客户端发送过来的请求。一旦收到请求，服务器（向客户端）发回一个状态行，比如"HTTP/1.1 200

OK"，和（响应的）消息，消息的消息体可能是请求的文件、错误消息、或者其它一些信息。

soap 协议：它描述了一种在分散或分布式的环境中如何交换信息的轻量级协议。soap在http协议的基础上，一个基于XML的协议。

不同：都是底层的通信协议，请求包的格式不同而已，soap包是XML格式,http纯文本格式。

关系：SOAP是个通信协议， SOAP在HTTP协议的基础上，把编写成XML的REQUEST参数, 放在HTTP BODY上提交个WEB SERVICE服务器(SERVLET，ASP什么的) 处理完成后，结果也写成XML作为RESPONSE送回用户端， 为了使用户端和WEB SERVICE可以相互对应，可以使用WSDL作为这种通信方式的描述文件，利用WSDL工具可以自动生成WS和用户端的框架文件，SOAP具备把复杂对象序列化捆绑到XML里去的能力。

Membrane SOAP Monitor，这个soap监听工具。这是德国的一家在线web服务注册公司predic8做的开源soap监听工具，简单好用。

windows下最新的版本为1.1.2版，下载地址：

/membrane/monitor/win86/

还有linux下的版本：/membrane/monitor/linux-x86/

源码：/membrane/monitor/src/

具体使用：

1) 运行exe文件(linux下可能是jar文件)；

2) 点击菜单项membrane->add rule ，进入后默认选项即可，点next；

3) 设置端口号(不产生冲突的任意端口)，点next；

4) 设置主机及端口(部署服务的地址及服务器的端口)，完成。

当调用网上发布的服务时，如检查qq是否在线的服务：

/webservices/?wsdl

可将4)中的host设为远端服务的网址，如，端口设为服务的端口，上面就是80端口。

当我们监听soap消息时，只要访问了web服务，即可在membrane的界面显示发送及接受的soap消息

XML Web Service的特点

二、Web Service开发

.net平台内建了对Web Service的支持，包括Web Service的构建和使用。与其它开发平台不同，使用.net平台，你不需要其他的工具或

者SDK就可以完成Web Service的开发了。.net Framework本身就全面支持Web Service，包括服务器端的请求处理器和对客户端发送和接受SOAP消息的支持。下来我们就一步一步的用Microsoft

Visual Studio .net 20058（后面简称 2008）创建和使用一个简单的Web Service。

2.1、用创建一个最简单的Web Service

首先，打开VS2005,打开"文件-新建-网站"，选择" Web服务"

查看代码，你会发现 2005已经为Web Service文件建立了缺省的框架。原始代码为：

?

默认工程里面已经有一个Hello World的方法了，

?

namespace WebService1

{

///

[WebService(Namespace = "/")]

//用于向 XML Web services 添加附加信息，如描述其功能的字符串。

//对于将要发布和执行的 XML Web services 来说，WebServiceAttribute 不是 //可以使用 WebServiceAttribute 为 XML Web services 指定不受公共语言运 //XML Web services 在成为公共之前，应该更改其默认的 XML 命名空间。

//每个 XML Web services 都需要唯一的 XML 命名空间来标识它，以便客户端的 XML Web services，

//但是已发布的 XML Web services 应该使用更具永久性的命名空间。例如，可 //虽然很多 XML Web services 的 XML 命名空间与 URL 很相似，但是，它们无用 创建的 XML Web services，可以使用 Namespace 属性更改默认的 XML

[WebServiceBinding(ConformsTo = rofile1_1)]//Confor

//声明定义一个或多个 XML Web services 方法的绑定。无法继承此类。

//按 Web 服务描述语言 (WSDL) 的定义，绑定类似于一个接口，原因是它定义 //每个 XML Web services 方法都是特定绑定中的一项操作。XML Web service //或者是在应用于实现 XML Web services 的类的 WebServiceBindingAttribu //XML Web services 可以通过将多个 WebServiceBindingAttribute 属性应用 //将一个或多个 WebServiceAttribute 属性应用到 XML Web services 之后，services 方法

//以指示由特定的 XML Web services 方法实现的绑定操作。

//设置 SoapDocumentMethodAttribute 或 SoapRpcMethodAttribute 的 Binding 属

[xItem(false)]//提供工具箱项的基实现。

// 若要允许使用 AJAX 从脚本中调用此 Web 服务，请取消对下行的注 // [Service]

public class Service1 : vice//

//表示此网站项目实现的一个 Web 服务，如同将此网站引用添加到项目时以 Visua {

[WebMethod]//向使用 创建的 XML Web services 中的某个方法添//初始化 WebMethodAttribute 类的新实例。

public string HelloWorld()

{

return "Hello World";

}

}

}

直接运行看看效果，

点击显示页面上图中的"HelloWorld"超链接，跳转到下一页面：

点击"调用"按钮，就可以看到用XML格式返回的Web Service结果下图。说明我们的Web Service环境没有问题，而且还初步接触了一下最简单的Web Service。

2.2、创建一个简单带有功能的Web Service

上面我们宏观的了解了webservice，其实它就是个对外的接口,里面有函数可供外部客户调用(注意:里面同样有客户不可调用的函数).假若我们是服务端,我们写好了个webservice,然后把它给了客户(同时我们给了他们调用规则),客户就可以在从服务端获取信息时处于一个相对透明的状态.即是客户不了解(也不需要)其过程,他们只获取数据.在代码文件里,如果我们写了一个函数后,希望此函数成为外部可调用的接口函数,我们必须在函数上面添上一行代码[WebMethod(Description="函数的描述信息")],如果你的函数没有这个申明,它将不能被用户引用.下来我们开始编写一个简单的Web

Service 的例子。

先把默认的HelloWorld方法注释掉，简单的写了求加减乘除运算的四个方法；

view plaincopy to clipboardprint?

using System;

using ;

using ;

using es;

using ols;

using ;

[WebService(Namespace = "/")]

[WebServiceBinding(ConformsTo =

rofile1_1)]

// 若要允许使用 AJAX 从脚本中调用此 Web 服务，请取消对下行的注释。

// [Service]

public class Service : vice

{

public Service () {

//如果使用设计的组件，请取消注释以下行

//InitializeComponent();

}

//[WebMethod]

//public string HelloWorld()

//{

// return "Hello World";

//}

[WebMethod(Description = "求和的方法")]

public double addition(double i, double j)

{

return i + j;

}

[WebMethod(Description = "求差的方法")]

public double subtract(double i, double j)

{

return i - j;

}

[WebMethod(Description = "求积的方法")]

public double multiplication(double i, double j)

{

return i * j;

}

[WebMethod(Description = "求商的方法")]

public double division(double i, double j)

{

if (j != 0)

return i / j;

else

return 0;

}

}

using System;

using ;

using ;

using es;

using ols;

using ;

[WebService(Namespace = "/")]

[WebServiceBinding(ConformsTo = rofile1_1)]

// 若要允许使用 AJAX 从脚本中调用此 Web 服务，请取消对下行的注释。

// [Service]

public class Service : vice

{

public Service () {

//如果使用设计的组件，请取消注释以下行

//InitializeComponent();

}

//[WebMethod]

//public string HelloWorld()

//{

// return "Hello World";

//}

[WebMethod(Description = "求和的方法")]

public double addition(double i, double j)

{

return i + j;

}

[WebMethod(Description = "求差的方法")]

public double subtract(double i, double j)

{

return i - j;

}

[WebMethod(Description = "求积的方法")]

public double multiplication(double i, double j)

{

return i * j;

}

[WebMethod(Description = "求商的方法")]

public double division(double i, double j)

{

if (j != 0)

return i / j;

else

return 0;

}

}

运行可以看到我们自己写的可以被调用的方法，如下图：

同样点击addition方法,进入addition方法的调用页。

在参数上面输入参数i=3,j=3,如上图,点击调用,就可以看到用XML格式返回的Web Service结果(i与j相加的结果)下图

到这里,我们会发现,其实webservice并不是那么的神秘,它也不过只是个接口,对我们而言,侧重点就是是接口函数的编写.

2.3、用调用Web Service

首先，打开VS2005,打开"文件-新建-网站"，选择"网站"。

选好存储位置，语言后点击确定，进入默认页面。然后先添加Web引用，把WebService引到当前的工程里面。方法是：在资源管理器中点击右键，选择添加Web 引用，调出对话框：

在URL中填入，前面写好的WebService运行后浏览器上面显示的地址（即：WebService发布后的访问地址 ），点击"前往"按钮，如上图，就会显示出所引用的WebService中可以调用的方法，然后点击"添加引用"，就将webservice引用到了当前的工程里面 ，如下图，解决方案中会出现引进来的WebService文件

我们在这就练习调用webservice的四个方法，做一个简单的调用的例子，先在网站的前台添加几个控件，代码如下：

view plaincopy to clipboardprint?

<%@ Page Language="C#"

AutoEventWireup="true" CodeFile=""

Inherits="_Default" %>

Transitional//EN"

"/TR/xhtml1/DTD/">

<%@ Page Language="C#"

AutoEventWireup="true" CodeFile=""

Inherits="_Default" %>

Transitional//EN"

"/TR/xhtml1/DTD/">

然后在后台写调用的代码，调用之前和使用其它的对象一样，要先实例化，实例化的方法是e a = new e();然后就可以通过a来访问WebService里面提供的方法了。在这个例子里面，动态的创建了一个button控件来触发WebService的调用，后台代码如下：

运行后可以看到效果，如下图所示，在前面两个Textbox里面输入两个操作数，在中间的下拉列表中选择操作符，然后点击"="号，将计算的结果输出到第三个Textbox里面。

而整个计算并不是在本地进行的，是在Web服务端进行计算的然后将结果通过XML返还给了调用方的，所以，在运行该程序的时候，WebService程序还必须启动，否则会报无法连接远程服务器的异常，如下图：

后台代码如下：

view plaincopy to clipboardprint?

using System;

using uration;

using ;

using ;

using ;

using ty;

using ;

using ntrols;

using trols;

using ts;

using ;

public partial class _Default :

{

protected void Page_Load(object sender, EventArgs e)

{

}

protected void Button1_Click(object sender, EventArgs e)

{

string selectFlag = ;

e web = new e();

if (("+"))

{

=(on((),())).ToString();

}

else if (("-"))

{

= (ct((),

())).ToString();

}

else if (("*"))

{

=

(lication((),

())).ToString();

}

else if (("/"))

{

= (on((),

())).ToString();

}

}

}

using System;

using uration;

using ;

using ;

using ;

using ty;

using ;

using ntrols;

using trols;

using ts;

using ;

public partial class _Default :

{

protected void Page_Load(object sender, EventArgs e)

{

}

protected void Button1_Click(object sender, EventArgs e)

{

string selectFlag = ;

e web = new e();

if (("+"))

{

=(on((),())).ToString();

}

else if (("-"))

{

= (ct((),

())).ToString();

}

else if (("*"))

{

=

(lication((),

())).ToString();

}

else if (("/"))

{

= (on((),

())).ToString();

}

}

}

到此一个一个简单的WebService的开发和调用就已经完成了，在实际应用中可以根据自己的需要，写一些功能强大的，复杂的WebService，不管多么复杂，整个流程都是这样的