C#怎么调用WebService C#添加服务引用并调用SOAP服务

来源:这里教程网 时间:2026-02-21 17:29:41 作者:

在C#中调用WebService(特别是基于SOAP的Web服务)通常通过“添加服务引用”的方式实现。这种方式会自动生成客户端代理类,简化调用过程。以下是详细步骤和示例。

1. 添加服务引用

要调用一个SOAP WebService,先需要将服务地址添加为服务引用:

打开Visual Studio中的项目(如控制台应用或WinForm)。 右键点击“解决方案资源管理器”中的“引用”或“依赖项”,选择“添加服务引用”(Add Service Reference)。 在弹出的窗口中,输入WebService的WSDL地址,例如:http://example.com/MyService.asmx?wsdl 点击“前往”按钮,工具会自动获取服务定义。 设置一个命名空间名称(如 MyWebService),然后点击“确定”。

此时,Visual Studio会在项目中生成客户端代理类和服务配置信息(在 app.config 或 web.config 中)。

2. 调用WebService方法

添加服务引用后,就可以使用生成的客户端类来调用服务方法。

以下是一个调用示例(假设服务有一个方法叫 GetData):

using System;
namespace WebServiceClient
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建客户端代理实例
            MyWebService.MyServiceClient client = new MyWebService.MyServiceClient();
            try
            {
                // 调用远程方法
                string result = client.GetData(123);
                Console.WriteLine("返回结果: " + result);
                // 如果有其他方法,也可以继续调用
                // var response = client.GetUserList();
            }
            catch (Exception ex)
            {
                Console.WriteLine("调用出错: " + ex.Message);
            }
            finally
            {
                // 关闭连接
                if (client.State == System.ServiceModel.CommunicationState.Opened)
                {
                    client.Close();
                }
            }
            Console.ReadLine();
        }
    }
}

3. 注意事项与常见问题

服务地址变更:如果服务地址发生变化,需右键“服务引用”并选择“更新服务引用”。 异步调用:生成的代理类通常提供同步和异步方法(如 GetDataAsync),可在UI应用中避免阻塞主线程。 配置文件:绑定(Binding)和终结点(Endpoint)信息保存在配置文件中,可手动调整超时、安全模式等。 证书或身份验证:若服务需要身份验证,可通过 client.ClientCredentials 属性设置用户名密码或证书。 .NET Core/.NET 5+:在较新项目中,“添加服务引用”功能由“添加 Connected Service”替代,推荐使用 WCF Web Service Reference Provider 工具。

4. 使用HttpClient手动调用(高级场景)

虽然不推荐普通场景下手动构造SOAP请求,但在某些集成需求中可能需要直接发送XML:

构造符合SOAP规范的XML请求体。 使用 HttpClient 发送POST请求,设置 Content-Type 为 text/xml,并指定 SOAPAction 头。 解析返回的SOAP响应XML。

这种方式复杂且易出错,建议优先使用服务引用方式。

基本上就这些。只要WebService提供了WSDL,C#就能方便地生成代理类并调用,整个过程自动化程度高,适合企业级系统集成。

相关推荐