NET应用程序中异步调用Web Service的几种方法

摘要

想必做.NET下开发的人对调用Web Service并不陌生，本文不介绍Web Service如何编写，只介绍.NET 应用程序中如何异步调用Web Service的几种方法。示例采用Windows应用程序。异步调用很有用，可以让客户端调用Web Service时（一般耗时未知），不至于阻塞客户端的UI线程导致假死的样子，还可以在调用Web Service的同时做些其它的处理。希望能对大家有所帮助，借此提出更好的解决方法。

测试程序界面

<shapetype coordsize="21600,21600" o:spt="75" o:preferrelative="t" path="m@4@5l@4@11@9@11@9@5xe" filled="f" stroked="f" id="_x0000_t75"><stroke joinstyle="miter"></stroke><formulas><f eqn="if lineDrawn pixelLineWidth 0"></f><f eqn="sum @0 1 0"></f><f eqn="sum 0 0 @1"></f><f eqn="prod @2 1 2"></f><f eqn="prod @3 21600 pixelWidth"></f><f eqn="prod @3 21600 pixelHeight"></f><f eqn="sum @0 0 1"></f><f eqn="prod @6 1 2"></f><f eqn="prod @7 21600 pixelWidth"></f><f eqn="sum @8 21600 0"></f><f eqn="prod @7 21600 pixelHeight"></f><f eqn="sum @10 21600 0"></f></formulas><path o:extrusionok="f" gradientshapeok="t" o:connecttype="rect"></path><lock v:ext="edit" aspectratio="t"></lock></shapetype><shape type="#_x0000_t75" style="width: 228.75pt; height: 168.75pt;" id="_x0000_i1025"><imagedata src="file:///C:%5CDOCUME%7E1%5CADMINI%7E1.KOS%5CLOCALS%7E1%5CTemp%5Cmsohtml1%5C01%5Cclip_image001.jpg" o:title="Async1"></imagedata></shape>

图一，调用前界面

<shape type="#_x0000_t75" style="width: 228pt; height: 245.25pt;" id="_x0000_i1026"><imagedata src="file:///C:%5CDOCUME%7E1%5CADMINI%7E1.KOS%5CLOCALS%7E1%5CTemp%5Cmsohtml1%5C01%5Cclip_image002.jpg" o:title="Async2"></imagedata></shape>

图二，调用后界面

详细代码实现

闲言少叙，直接进入主题吧。首先一个声明一个类（将来在客户端与服务器间传递）：

publicclassClass1
...{
privateint_ID;
privatestring_Name;
publicintID
...{
get
...{
return_ID;
}
set
...{
_ID=value;
}
}

publicstringName
...{
get
...{
return_Name;
}
set
...{
_Name=value;
}
}
}

其次，声明一个Web方法：

//省略系统生成的WebService声明代码，采用默认的

publicclassService1:System.Web.Services.WebService

{

//省略系统生成的WebService声明代码，采用默认的

[WebMethod]

publicClass1GetClass1(intp_TimeSpan)

{

System.Threading.Thread.Sleep(p_TimeSpan);//线程停止一段执行,假设一段处理的时间

Class1r=newClass1();

r.Name="AsyncCall";

r.ID=p_TimeSpan;

returnr;

}

}

客户端调用代码，设计一个Windows Form窗体来测试，放入3个按钮控件（分别代表3种异步调用方法），一个进度条控件（表示调用Web Service后，客户端继续进行某些操作）。先把3种方法介绍一下：

1. 利用Backgroundworker对象，所在命名空间System.ComponentModel。MSDN原文解释：BackgroundWorker 类允许您在单独的专用线程上运行操作。耗时的操作（如下载和数据库事务）在长时间运行时可能会导致用户界面 (UI) 似乎处于停止响应状态。如果您需要能进行响应的用户界面，而且面临与这类操作相关的长时间延迟，则可以使用 BackgroundWorker 类方便地解决问题。

2. 利用wsdl.exe生成Web Service的客户端代理类，调用其中WebMethod的Async方法。

3. 利用wsdl.exe生成Web Service的客户端代理类，分别调用其中WebMethod的Begin与End方法。

先用wsdl.exe把上面的Web Service生成客户端代理类并把他编译成类库引入Windows应用项目（这里我没有编译类库，而是直接把代理类.cs文件加入到了Windows应用项目中）。

进入Visual Studio命令行模式，运行

wsdl /out:MyService.cs http://localhost:2732/Service1.asmx

参数说明：第二个参数是Web Service的URL，这个是我机器的本地环境，其他人需要根据情况修改！

注：第一种方式的调用，不采用手动生成Web Service客户端代理类也可以（项目中直接添加Web引用）。后面两种方法都是通过Web Service代理类中提供的方法实现，因此必须生成这个代理类。

看一下处理进度条控件值的代码，几种调用方法都会用到，

privatevoidChangeProcessBar()

{

for(inti=0;i<10;i++)

{

progressBar1.Value=i;

//不知道用多少时间，慢慢走吧:)

System.Threading.Thread.Sleep(500);

}

}

第一种方式调用，

privatevoidbutton1_Click(objectsender,EventArgse)

{

AsyncCall_In_Backgroundworker();

}



#regionAsyncCall_In_Backgroundworker

privatevoidAsyncCall_In_Backgroundworker()

{

BackgroundWorkerbackgroundworker=newBackgroundWorker();

backgroundworker.DoWork+=newDoWorkEventHandler(back_DoWork);//注册具体异步处理的方法

backgroundworker.RunWorkerCompleted+=newRunWorkerCompletedEventHandler(back_RunWorkerCompleted);//注册调用完成后的回调方法

backgroundworker.RunWorkerAsync();//这里开始异步调用

ChangeProcessBar();//调用同时客户端处理不停止

}



voidback_RunWorkerCompleted(objectsender,RunWorkerCompletedEventArgse)

{

if(e.Error!=null)

throwe.Error;

progressBar1.Value=progressBar1.Maximum;//调用完成了,把客户端进度条填充满

Class1result=e.ResultasClass1;//结果转化为Class1对象

MessageBox.Show("IDis"+(result.ID.ToString()+",Nameis"+result.Name.ToString()));//显示从服务器获取的对象值

}



voidback_DoWork(objectsender,DoWorkEventArgse)

{

Service1service1=newService1();//WebService代理类

e.Result=service1.GetClass1(2500);//调用Web方法GetClass1，结果赋值给DoWorkEventArgs的Result对象

}

#endregion

第二种方式调用，

privatevoidbutton2_Click(objectsender,EventArgse)

{

AsynCall_In_WebServiceProxy();

}



#regionAsynCall_In_WebServiceProxy

privatevoidAsynCall_In_WebServiceProxy()

{

Service1service1=newService1();//WebService代理类

service1.GetClass1Async(3000);//这里开始异步调用

service1.GetClass1Completed+=newGetClass1CompletedEventHandler(s_GetClass1Completed);//注册调用完成后的回调方法

ChangeProcessBar();//调用同时客户端处理不停止

}



voids_GetClass1Completed(objectsender,GetClass1CompletedEventArgse)

{

if(e.Error!=null)

throwe.Error;

progressBar1.Value=progressBar1.Maximum;//调用完成了,把客户端进度条填充满

Class1result=e.ResultasClass1;//结果转化为Class1对象

MessageBox.Show("IDis"+(result.ID.ToString()+",Nameis"+result.Name.ToString()));//显示从服务器获取的对象值

}

#endregion

第三种调用，

privatevoidbutton3_Click(objectsender,EventArgse)

{

AsynCall_In_WebServiceProxyOther();

}



#regionAsynCall_In_WebServiceProxyOther

privatevoidAsynCall_In_WebServiceProxyOther()

{

Service1service1=newService1();//WebService代理类

service1.BeginGetClass1(3000,OnWebMethodCompleted,null);//这里开始异步调用

ChangeProcessBar();//调用同时客户端处理不停止

}



privatevoidOnWebMethodCompleted(IAsyncResultp_AsyncResult)

{//方法声明必须带有IAsyncResult类型对象

Service1service1=newService1();//WebService代理类

Class1result=service1.EndGetClass1(p_AsyncResult);//结束调用时结果返回

MessageBox.Show("IDis"+(result.ID.ToString()+",Nameis"+result.Name.ToString()));//显示从服务器获取的对象值

}

#endregion

细心的读者可能发现第三种方法并没有在调用完成后把客户端的进度条填满，的确在OnWebMethodCompleted中调用progressBar1.Value = progressBar1.Maximum时会出现InvalidOperationException异常，线程间操作无效: 从不是创建控件“progressBar1”的线程访问它。这个异常恐怕在.net下写过多线程操作的人都看到过 ：）。可以声明一个委托，把处理进度条的代码放到一个方法中，用窗体的Invoke去安全的调用它。好下面把修改的代码写出来，注意加粗的部分

privatedelegatevoidMaxProcessBarEventHandle();//声明最大化客户端进度条控件方法的委托

privatevoidOnWebMethodCompleted(IAsyncResultp_AsyncResult)

{

Service1service1=newService1();

Class1result=service1.EndGetClass1(p_AsyncResult);

MessageBox.Show("IDis"+(result.ID.ToString()+",Nameis"+result.Name.ToString()));

this.Invoke(newMaxProcessBarEventHandle(MaxProcessBar));//从进度条创建的线程安全调用MaxProcessBar方法

}



privatevoidMaxProcessBar()

{

//客户端进度条最大化方法

progressBar1.Value=progressBar1.Maximum;

}