如何使用C#创建WebService

C#学习到一定程度会涉及到C#创建WebService的一些高阶知识,本文试图对此做一个简单的介绍。

假设A是客户端,B是webservice服务端,用户通过http协议向服务器发送soap请求,webservice返回客户端Xml格式的数据。

现在我们看一看创建一个C#创建WebService的大致过程:

服务端的webservice是必须要建的。中间的soap,Xml我们不用去关心,在客户端这边,比较重要的是如何从webservice取得对象?答案是用的是proxy对象。客户端由代理对象(proxy)负责与webservice的通信。所以在客户端使用webservice,完全和使用一个本地对象是一样的。

我们现在以一个简单的C#创建WebService实例来说明。

 打开vs.Net,新建工程(asp.Net  web服务),在位置中键入http://localhost/webserver,其中webserver就是工程的名字。确定后,出现一个Service1.asmx.cx,双击,出现代码窗口,

 
 
 
  1. using  System;   
  2. using  System.Collections;   
  3. using  System.ComponentModel;   
  4. using  System.Data;   
  5. using  System.Diagnostics;   
  6. using  System.Web;   
  7. using  System.Web.Services;   
  8. namespace  webserver   
  9. {   
  10. ///     
  11. ///  Service1  的摘要说明。   
  12. ///  
  13.    
  14. (1)   
  15. public  class  Service1  :    
  16. System.Web.Services.WebService   
  17. {   
  18. public  Service1()   
  19. {   
  20. //CODEGEN:该调用是  ASP.Net  Web    
  21. 服务设计器所必需的   
  22. InitializeComponent();   
  23. }   
  24. #region  Component  Designer  generated  code   
  25. //Web  服务设计器所必需的   
  26. private  IContainer  components  =  null;   
  27. ///     
  28. ///  设计器支持所需的方法  -    
  29. 不要使用代码编辑器修改   
  30. ///  此方法的内容。   
  31. ///  
  32.    
  33. private  void  InitializeComponent()   
  34. {   
  35. }   
  36. ///     
  37. ///  清理所有正在使用的资源。   
  38. ///  
  39.    
  40. protected  override  void  Dispose  
  41. (  bool  disposing  )   
  42. {   
  43. if(disposing  &&  components  !=  null)   
  44. {   
  45. components.Dispose();   
  46. }   
  47. base.Dispose(disposing);   
  48. }   
  49. #endregion   
  50. //  WEB  服务示例   
  51. //  HelloWorld()  示例服务返回字符串  Hello  World   
  52. //  若要生成,请取消注释下列行,然后保存并生成项目   
  53. //  若要测试此  Web  服务,请按  F5  键   
  54. // [WebMethod]   
  55. // public  string  HelloWorld()   
  56. // {   
  57. // return  "Hello  World";   
  58. // }   
  59. }   
  60. }   

下面在(1)处加入

[WebService(Namespace="http://localhost/webserver/")]

这是因为soap是基于http协议上的,客户端无法知道webservice位于那个服务器上。在实际应用中,比如http://www.ourfly.com上放置这个webservice,则Namespace改为http://www.ourfly.com/webserver.

下面我们给这个webservice添加一个方法。

 
 
 
  1. // [WebMethod]   
  2. // public  string  HelloWorld()   
  3. // {   
  4. // return  "Hello  World";   
  5. // }   
  6. 微软帮我们写好了一个,接着添加一个方法。  
  7. 方法名称叫show.   
  8. [WebMethod]   
  9. public  string  show(string  yourname)   
  10. {   
  11. return  “http://www.ourfly.com”+”欢迎”+yourname;   
  12. }   
  13. 现在,就可以运行了,按F5,点击show,输入你的名字,  
  14. 然后点击invote 看到了吧。   
  15. 〈 ?Xml  version="1.0"  encoding="utf-8"  ?〉     
  16. 〈 string  Xmlns="http://tempuri.org/"〉  
  17. http://www.ourfly.com欢迎yyg〈 /string〉  

成功了。打开bin目录,Vs.Net已经将proxy做好了.webserver.dll.

现在我们在不同的环境下测试:

1.打开vs.Net,新建”windows应用程序”工程,命名为Client,增加按钮,文本框。

现在要用到代理了,右键单击右边的reference(引用),选择”添加引用”,选择浏览,找到webserver目录下的bin目录下的webserver.dll
再加入一个system.web.webservices的引用,在列表中有。

在form1.cs里,加入

using System.Web.Services;

using webserver;

然后在

private  System.Windows.Forms.Button  button1;

private  System.Windows.Forms.TextBox  textBox1;

后面,插入

private  webserver.service1  Client

建立一个service1的实例。双击按钮,代码如下:

 
 
 
  1. private  void  button1_Click  
  2. (object  sender,  System.EventArgs  e)   
  3. {   
  4. Client  =new  Service1();   
  5. string  name;   
  6. name=Client.show("龙卷风.Net");   
  7. textBox1.Text=name;   
  8. }   

按F5,运行工程,点击按钮,文本框中显示 http://www.ourfly.com欢迎龙卷风.Net

2. Asp.Net  web窗口的测试

方法与上面的一模一样,添加引用,建立service1的实例 在此不在细说。

3.在VB中测试

这个就要相对来说复杂一些 ,首先在VB中建立一个”标准EXE”的工程。添加引用:Microsoft  Soap  Type  library。

注意:如果没有安装Microsoft  Soap  Toolkit,是没有这个类型库的。 可以在http://www.ourfly.com中下载。

 
 
 
  1. 添加一个text   
  2. Private  Sub  Form_Load()   
  3. Text1.Text  =  add()   
  4. End  Sub   
  5. Public  Function  Add()  As  String   
  6. Dim  objSoapClient  As  New    
  7. SoapClient objSoapClient.  
  8. ClientProperty("ServerHTTPRequest")  =  True   
  9. Call  objSoapClient.mssoapinit(  
  10. "http://localhost/webserver/service1.asmx?WSDL",    
  11. "Service1",  "Service1Soap")   
  12. 这句也可以   
  13. objSoapClient.mssoapinit(  
  14. "http://localhost/webserver/service1.asmx?WSDL")   
  15. Add  =  objSoapClient.Show("龙卷风.Net")   
  16. End  Function   

调试成功需要注意的:

运行服务端webservice的程序,出现下面时 支持下列操作。有关正式定义。

点击服务说明,会得到完整的wsdl文件 http://localhost/webserver/Service1.asmx?WSDL

我们就要使用这个文件,其中包含了我们定义的方法等等。Mssoapinit(bstrWSDLFile  as  string,[bStrServiceName  as  string  ],[bStrport  as  string  ]  ,[bstrWSMLDile  as  string])的用法: 其中第二个,第三个参数在wsdl文件中可以找到。也可以省略。

这就是C#创建WebService的简单过程,希望对您有所帮助。

【编辑推荐】

  1. C#中定义装箱和拆箱详解
  2. 浅谈C#类型系统
  3. 三种不同的C#异常类型
  4. 详细介绍C#编译器
  5. C#异常处理的相关介绍
THE END