在ASP.NET Core调用WebService

一、前言

现实生产中，有一些比较老的系统对外提供的接口都是WebService形式的，如果是使用.NET Framework创建的项目调用WebService非常方便，网上有很多代码示例，这里不在讲解，下面我们讲解如何在ASP.NET Core项目里面调用WebService。首先我们需要创建一个WebService项目和一个ASP.NET Core WebApi项目。创建的WebService代码如下：

using System.Web.Services;

namespace CoreCallWebServiceTest
{
    /// <summary>
    /// CoreTest 的摘要说明
    /// </summary>
    [WebService(Namespace = "http://tempuri.org/")]
    [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
    [System.ComponentModel.ToolboxItem(false)]
    // 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务，请取消注释以下行。
    // [System.Web.Script.Services.ScriptService]
    public class CoreTest : System.Web.Services.WebService
    {

        [WebMethod]
        public string HelloWorld()
        {
            return "Hello World";
        }

        /// <summary>
        ///
        /// </summary>
        /// <param name="para"></param>
        /// <returns></returns>
        [WebMethod]
        public string TestMethod(string para)
        {
            return $"输入参数：{para}";
        }
    }
}

里面分别有一个无参和有参的方法。我们在ASP.NET Core WebApi项目里面分别调用这两个方法并输出。

二、引用WebService

首先我们在创建好的ASP.NET Core WebApi项目里面添加WebService的引用。

1、在依赖项上面右键，选择“添加连接的服务”，如图所示：

2、选择“Microsoft WCF Web Service Referenct Provider”，如图所示：

3、添加服务引用。如图所示：

配置完以后，点击“下一步”，去掉重新使用引用的程序集中的类型签名的复选框。如果不去掉复选框，生成的时候可能会报错。

直接点击“完成”按钮即可。慢慢等待配置完成：

配置完成界面如图所示：

这样就添加完了，下面开始在代码里面调用提供的WebService里面的方法。

三、在代码中调用WebService

我们添加一个名为Test的控制器，里面有一个Get方法，返回WebService里面两个方法的返回值，代码如下：

using System.ServiceModel;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using TestWebService;

namespace AspNetCoreDemo.Controllers
{
    [Route("api/Test")]
    [ApiController]
    public class TestController : ControllerBase
    {
        [HttpGet]
        public string Get()
        {
            //创建 HTTP 绑定对象
            var binding = new BasicHttpBinding();
            //根据 WebService 的 URL 构建终端点对象，参数是提供的WebService地址
            var endpoint = new EndpointAddress(@"http://localhost:37907/CoreTest.asmx");
            //创建调用接口的工厂，注意这里泛型只能传入接口 泛型接口里面的参数是WebService里面定义的类名+Soap
            var factory = new ChannelFactory<CoreTestSoap>(binding, endpoint);
            //从工厂获取具体的调用实例
            var callClient = factory.CreateChannel();
            //调用具体的方法，这里是 HelloWorldAsync 方法
            Task<HelloWorldResponse> responseTask = callClient.HelloWorldAsync(new HelloWorldRequest());
            //获取结果
            HelloWorldResponse response = responseTask.Result;
            // 获取HelloWorld方法的返回值
            string result1 = response.Body.HelloWorldResult;

            // 调用TestMethod方法，不传递参数
            Task<TestMethodResponse> testResponse = callClient.TestMethodAsync(new TestMethodRequest());
            // 获取
            string result2 = testResponse.Result.Body.TestMethodResult;

            // 调用TestMethod方法，并传递参数
            TestMethodRequestBody body = new TestMethodRequestBody("测试TestMethod方法");
            Task<TestMethodResponse> testResponsePara = callClient.TestMethodAsync(new TestMethodRequest(body));
            // 获取
            string result3 = testResponse.Result.Body.TestMethodResult;

            return $"HelloWorld方法返回值:{result1},TestMethod方法不传递参数返回值:{result2},TestMethod方法传递参数的返回值:{result3}";
        }
    }
}

我们在WebService里面定义的TestMethod方法有一个string类型的参数，调用的时候有两个重载函数，一个无参，一个有参，看一下自动生成的Reference.cs类里面的代码：

发现TestMethodRequestBody有两个构造函数：一个无参，一个有参。我们在浏览器里面调用Get方法，程序输出结果：

除了上面的代码，也可以使用下面的代码进行调用：

using System.ServiceModel;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using TestWebService;

namespace AspNetCoreDemo.Controllers
{
    [Route("api/Test")]
    [ApiController]
    public class TestController : ControllerBase
    {
        [HttpGet]
        public string Get()
        {
            #region 调用方法1
            ////创建 HTTP 绑定对象
            //var binding = new BasicHttpBinding();
            ////根据 WebService 的 URL 构建终端点对象，参数是提供的WebService地址
            //var endpoint = new EndpointAddress(@"http://localhost:37907/CoreTest.asmx");
            ////创建调用接口的工厂，注意这里泛型只能传入接口 泛型接口里面的参数是WebService里面定义的类名+Soap
            //var factory = new ChannelFactory<CoreTestSoap>(binding, endpoint);
            ////从工厂获取具体的调用实例
            //var callClient = factory.CreateChannel();
            ////调用具体的方法，这里是 HelloWorldAsync 方法
            //Task<HelloWorldResponse> responseTask = callClient.HelloWorldAsync(new HelloWorldRequest());
            ////获取结果
            //HelloWorldResponse response = responseTask.Result;
            //// 获取HelloWorld方法的返回值
            //string result1 = response.Body.HelloWorldResult;

            //// 调用TestMethod方法，不传递参数
            //Task<TestMethodResponse> testResponse = callClient.TestMethodAsync(new TestMethodRequest());
            //// 获取
            //string result2 = testResponse.Result.Body.TestMethodResult;

            //// 调用TestMethod方法，并传递参数
            //TestMethodRequestBody body = new TestMethodRequestBody("测试TestMethod方法");
            //Task<TestMethodResponse> testResponsePara = callClient.TestMethodAsync(new TestMethodRequest(body));
            //// 获取
            //string result3 = testResponsePara.Result.Body.TestMethodResult;
            #endregion

            #region 调用方法2
            BasicHttpBinding binding = new BasicHttpBinding();

            EndpointAddress address = new EndpointAddress("http://localhost:37907/CoreTest.asmx");

            CoreTestSoapClient client = new CoreTestSoapClient(binding, address);

            Task<HelloWorldResponse> responseTask = client.HelloWorldAsync();
            HelloWorldResponse response = responseTask.Result;
            // 获取HelloWorld方法的返回值
            string result1 = response.Body.HelloWorldResult;

            // 调用TestMethod方法，这时必须传入参数
            Task<TestMethodResponse> testResponseTask = client.TestMethodAsync("测试TestMethod方法");
            // 获取TestMethod方法的返回值
            string result2 = testResponseTask.Result.Body.TestMethodResult;
            #endregion
            return $"HelloWorld方法返回值:{result1},TestMethod方法返回值:{result2}";
        }
    }
}

在这种方式中，调用有参的方法必须要传递参数。

程序运行结果：

如果以后WebService有更新，只需要更新添加的服务引用即可，如图所示：