C#操作webservice经典入门教程及实例.docx
- 文档编号：9623845
- 上传时间：2023-02-05
- 格式：DOCX
- 页数：17
- 大小：198.57KB
C#操作webservice经典入门教程及实例.docx
《C#操作webservice经典入门教程及实例.docx》由会员分享，可在线阅读，更多相关《C#操作webservice经典入门教程及实例.docx（17页珍藏版）》请在冰豆网上搜索。
C#操作webservice经典入门教程及实例
WebService基本概念
WebService也叫XMLWebServiceWebService是一种可以接收从Internet或者Intranet上的其它系统中传递过来的请求，轻量级的独立的通讯技术。
是:
通过SOAP在Web上提供的软件（服务），使用WSDL文件进行（说明），并通过（UDDI）进行注册。
XML：
（ExtensibleMarkupLanguage）扩展型可标记语言。
面向短期的临时数据处理、面向万维网络，是Soap的基础。
Soap：
（SimpleObjectAccessProtocol）简单对象存取协议。
是XMLWebService的通信协议。
当用户通过UDDI找到你的WSDL描述文档后，他通过可以SOAP调用你建立的Web服务中的一个或多个操作。
SOAP是XML文档形式的调用方法的规范，它可以支持不同的底层接口，像HTTP（S）或者SMTP。
WSDL：
（WebServicesDescriptionLanguage） WSDL文件是一个XML文档，用于说明一组 SOAP消息以及如何交换这些消息。
大多数情况下由软件自动生成和使用。
UDDI（UniversalDescription,Discovery,andIntegration）是一个主要针对Web服务供应商和使用者的新项目。
在用户能够调用Web服务之前，必须确定这个服务内包含哪些商务方法，找到被调用的接口定义，还要在服务端来编制软件，UDDI是一种根据描述文档来引导系统查找相应服务的机制。
UDDI利用SOAP消息机制（标准的XML/HTTP）来发布，编辑，浏览以及查找注册信息。
它采用XML格式来封装各种不同类型的数据，并且发送到注册中心或者由注册中心来返回需要的数据。
概念补充：
httpsoap关系
http:
是一个客户端和服务器端请求和应答的标准（TCP）。
http协议其目的是为了提供一种发布和接收htttp页面的方法
一http协议的客户端与服务器的交互：
由HTTP客户端发起一个请求，建立一个到服务器指定端口（默认是80端口）的TCP连接。
HTTP服务器则在那个端口监听客户端发送过来的请求。
一旦收到请求，服务器（向客户端）发回一个状态行，比如"HTTP/1.1200OK"，和（响应的）消息，消息的消息体可能是请求的文件、错误消息、或者其它一些信息。
soap协议：
它描述了一种在分散或分布式的环境中如何交换信息的轻量级协议。
soap在http协议的基础上，一个基于XML的协议。
不同：
都是底层的通信协议，请求包的格式不同而已，soap包是XML格式,http纯文本格式。
关系：
SOAP是个通信协议，SOAP在HTTP协议的基础上，把编写成XML的REQUEST参数,放在HTTPBODY上提交个WEBSERVICE服务器（SERVLET，ASP什么的）处理完成后，结果也写成XML作为RESPONSE送回用户端， 为了使用户端和WEBSERVICE可以相互对应，可以使用WSDL作为这种通信方式的描述文件，利用WSDL工具可以自动生成WS和用户端的框架文件，SOAP具备把复杂对象序列化捆绑到XML里去的能力。
MembraneSOAPMonitor，这个soap监听工具。
这是德国的一家在线web服务注册公司predic8做的开源soap监听工具，简单好用。
windows下最新的版本为1.1.2版，下载地址：
还有linux下的版本：
源码：
具体使用：
1） 运行exe文件（linux下可能是jar文件）；
2） 点击菜单项membrane->addrule，进入后默认选项即可，点next；
3） 设置端口号（不产生冲突的任意端口），点next；
4） 设置主机及端口（部署服务的地址及服务器的端口），完成。
当调用网上发布的服务时，如检查qq是否在线的服务：
可将4）中的host设为远端服务的网址，如，端口设为服务的端口，上面就是80端口。
当我们监听soap消息时，只要访问了web服务，即可在membrane的界面显示发送及接受的soap消息
XMLWebService的特点
二、WebService开发
.net平台内建了对WebService的支持，包括WebService的构建和使用。
与其它开发平台不同，使用.net平台，你不需要其他的工具或者SDK就可以完成WebService的开发了。
.netFramework本身就全面支持WebService，包括服务器端的请求处理器和对客户端发送和接受SOAP消息的支持。
下来我们就一步一步的用MicrosoftVisualStudio.net20058（后面简称VS.Net2008）创建和使用一个简单的WebService。
2.1、用创建一个最简单的WebService
首先，打开VS2005,打开"文件-新建-网站"，选择"ASP.NETWeb服务"
查看Service.cs代码，你会发现VS.Net2005已经为WebService文件建立了缺省的框架。
原始代码为：
?
默认工程里面已经有一个HelloWorld的方法了，
?
namespaceWebService1
{
///
///Service1的摘要说明
///
[WebService（Namespace="http:
//tempuri.org/"）]
//用于向XMLWebservices添加附加信息，如描述其功能的字符串。
//对于将要发布和执行的XMLWebservices来说，WebServiceAttribute不是必需的。
//可以使用WebServiceAttribute为XMLWebservices指定不受公共语言运行库标识符（用于XMLWebservices的“服务说明”和“服务帮助”页）规则限制的名称。
//XMLWebservices在成为公共之前，应该更改其默认的XML命名空间。
//每个XMLWebservices都需要唯一的XML命名空间来标识它，以便客户端应用程序能够将它与网络上的其他服务区分开来。
http:
//tempuri.org/可用于正在开发中的XMLWebservices，
//但是已发布的XMLWebservices应该使用更具永久性的命名空间。
例如，可以将公司的Internet域名作为XML命名空间的一部分。
//虽然很多XMLWebservices的XML命名空间与URL很相似，但是，它们无需指向Web上的某一实际资源。
（XMLWebservices的XML命名空间是URI。
）对于使用ASP.NET创建的XMLWebservices，可以使用Namespace属性更改默认的XML命名空间。
[WebServiceBinding（ConformsTo=WsiProfiles.BasicProfile1_1）]//ConformsTo 获取或设置绑定声称所符合的Web服务互操作性（WSI）规范。
//声明定义一个或多个XMLWebservices方法的绑定。
无法继承此类。
//按Web服务描述语言（WSDL）的定义，绑定类似于一个接口，原因是它定义一组具体的操作。
//每个XMLWebservices方法都是特定绑定中的一项操作。
XMLWebservices方法是XMLWebservices的默认绑定的成员，
//或者是在应用于实现XMLWebservices的类的WebServiceBindingAttribute中指定的绑定的成员。
//XMLWebservices可以通过将多个WebServiceBindingAttribute属性应用于XMLWebservices来实现多个绑定。
//将一个或多个WebServiceAttribute属性应用到XMLWebservices之后，可以将SoapDocumentMethodAttribute或SoapRpcMethodAttribute应用到各个XMLWebservices方法
//以指示由特定的XMLWebservices方法实现的绑定操作。
//设置SoapDocumentMethodAttribute或SoapRpcMethodAttribute的Binding属性以指定XMLWebservices方法正在为其实现操作的绑定。
[System.ComponentModel.ToolboxItem（false）]//提供工具箱项的基实现。
//若要允许使用ASP.NETAJAX从脚本中调用此Web服务，请取消对下行的注释。
//[System.Web.Script.Services.ScriptService]
publicclassService1:
System.Web.Services.WebService//
//表示此网站项目实现的一个Web服务，如同将此网站引用添加到项目时以VisualStudio生成的.asmx文件表示一样。
{
[WebMethod]//向使用ASP.NET创建的XMLWebservices中的某个方法添加此属性（Attribute）后，就可以从远程Web客户端调用该方法。
无法继承此类。
//初始化WebMethodAttribute类的新实例。
publicstringHelloWorld（）
{
return"HelloWorld";
}
}
}
直接运行看看效果，
点击显示页面上图中的"HelloWorld"超链接，跳转到下一页面：
点击"调用"按钮，就可以看到用XML格式返回的WebService结果下图。
说明我们的WebService环境没有问题，而且还初步接触了一下最简单的WebService。
2.2、创建一个简单带有功能的WebService
上面我们宏观的了解了webservice，其实它就是个对外的接口,里面有函数可供外部客户调用（注意:
里面同样有客户不可调用的函数）.假若我们是服务端,我们写好了个webservice,然后把它给了客户（同时我们给了他们调用规则）,客户就可以在从服务端获取信息时处于一个相对透明的状态.即是客户不了解（也不需要）其过程,他们只获取数据.在代码文件里,如果我们写了一个函数后,希望此函数成为外部可调用的接口函数,我们必须在函数上面添上一行代码[WebMethod（Description="函数的描述信息"）],如果你的函数没有这个申明,它将不能被用户引用.下来我们开始编写一个简单的WebService的例子。
先把默认的HelloWorld方法注释掉，简单的写了求加减乘除运算的四个方法；
viewplaincopytoclipboardprint?
usingSystem;
usingSystem.Linq;
usingSystem.Web;
usingSystem.Web.Services;
usingSystem.Web.Services.Protocols;
usingSystem.Xml.Linq;
[WebService（Namespace="http:
//tempuri.org/"）]
[WebServiceBinding（ConformsTo=WsiProfiles.BasicProfile1_1）]
//若要允许使用ASP.NETAJAX从脚本中调用此Web服务，请取消对下行的注释。
//[System.Web.Script.Services.ScriptService]
publicclassService:
System.Web.Services.WebService
{
publicService（）{
//如果使用设计的组件，请取消注释以下行
//InitializeComponent（）;
}
//[WebMethod]
//publicstringHelloWorld（）
//{
// return"HelloWorld";
//}
[WebMethod（Description="求和的方法"）]
publicdoubleaddition（doublei,doublej）
{
returni+j;
}
[WebMethod（Description="求差的方法"）]
publicdoublesubtract（doublei,doublej）
{
returni-j;
}
[WebMethod（Description="求积的方法"）]
publicdoublemultiplication（doublei,doublej）
{
returni*j;
}
[WebMethod（Description="求商的方法"）]
publicdoubledivision（doublei,doublej）
{
if（j!
=0）
returni/j;
else
return0;
}
}
usingSystem;
usingSystem.Linq;
usingSystem.Web;
usingSystem.Web.Services;
usingSystem.Web.Services.Protocols;
usingSystem.Xml.Linq;
[WebService（Namespace="http:
//tempuri.org/"）]
[WebServiceBinding（ConformsTo=WsiProfiles.BasicProfile1_1）]
//若要允许使用ASP.NETAJAX从脚本中调用此Web服务，请取消对下行的注释。
//[System.Web.Script.Services.ScriptService]
publicclassService:
System.Web.Services.WebService
{
publicService（）{
//如果使用设计的组件，请取消注释以下行
//InitializeComponent（）;
}
//[WebMethod]
//publicstringHelloWorld（）
//{
// return"HelloWorld";
//}
[WebMethod（Description="求和的方法"）]
publicdoubleaddition（doublei,doublej）
{
returni+j;
}
[WebMethod（Description="求差的方法"）]
publicdoublesubtract（doublei,doublej）
{
returni-j;
}
[WebMethod（Description="求积的方法"）]
publicdoublemultiplication（doublei,doublej）
{
returni*j;
}
[WebMethod（Description="求商的方法"）]
publicdoubledivision（doublei,doublej）
{
if（j!
=0）
returni/j;
else
return0;
}
}
运行可以看到我们自己写的可以被调用的方法，如下图：
同样点击addition方法,进入addition方法的调用页。
在参数上面输入参数i=3,j=3,如上图,点击调用,就可以看到用XML格式返回的WebService结果（i与j相加的结果）下图
到这里,我们会发现,其实webservice并不是那么的神秘,它也不过只是个接口,对我们而言,侧重点就是是接口函数的编写.
2.3、用ASP.NET调用WebService
首先，打开VS2005,打开"文件-新建-网站"，选择"ASP.NET网站"。
选好存储位置，语言后点击确定，进入默认页面。
然后先添加Web引用，把WebService引到当前的工程里面。
方法是：
在资源管理器中点击右键，选择添加Web引用，调出对话框：
在URL中填入，前面写好的WebService运行后浏览器上面显示的地址（即：
WebService发布后的访问地址），点击"前往"按钮，如上图，就会显示出所引用的WebService中可以调用的方法，然后点击"添加引用"，就将webservice引用到了当前的工程里面，如下图，解决方案中会出现引进来的WebService文件
我们在这就练习调用webservice的四个方法，做一个简单的调用的例子，先在网站的前台添加几个控件，代码如下：
viewplaincopytoclipboardprint?
<%@PageLanguage="C#"AutoEventWireup="true" CodeFile="Default.aspx.cs"Inherits="_Default"%>
DOCTYPEhtmlPUBLIC"-//W3C//DTDXHTML1.0Transitional//EN""http:
//www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
//www.w3.org/1999/xhtml">
TextBoxID="Num1"runat="server">
TextBox>
TextBoxID="Num2"runat="server">
TextBox>
ButtonID="Button1"runat="server"Text="="onclick="Button1_Click"/> TextBoxID="Result"runat="server"> TextBox>