在 Visual Studio 中为旧版 .NET Framework 项目添加 ASMX WebService 引用，需右键项目→“添加服务引用”→点“高级”→“添加 Web 引用”，输入 WSDL 地址（如 http://example.com/Service.asmx?wsdl），取消勾选“重用类型”，命名空间设简洁名；若遇 TLS 错误，须在 Application_Start 中设置 SecurityProtocol = Tls | Tls11；代理类无真正 async 方法，Header 需手动继承 SoapHeader 并绑定。
怎么用 Visual Studio 为旧项目添加 WebService 引用
旧版 .NET Framework 项目（如 .NET 4.0/4.5）调用传统 ASMX WebService，必须用「添加服务引用」配合 wsdl.exe 或设计器生成代理类，不能用现代的 dotnet-svcutil 或 Add Connected Service（后者默认走 WCF 或 OpenAPI）。VS 2019 及更早版本仍保留该能力，但需手动指定 URL 并关闭“重用类型”以防命名冲突。
- 右键项目 → “添加服务引用…” → 在地址栏输入
http://example.com/Service.asmx?wsdl→ 点击“转到” - 若提示证书错误或 HTTP 302 重定向失败，先用浏览器打开 WSDL 地址确认可访问；部分老服务强制要求 HTTP（非 HTTPS），需在 VS 的“高级”→“支持通用类型”里取消勾选“在引用的程序集中重用类型”
- 命名空间建议填简洁名如
LegacySvc，避免和项目已有命名空间（如MyApp.Services）重复导致编译报错The type 'X' exists in both 'A.dll' and 'B.dll'
调用时出现“请求已中止: 未能创建 SSL/TLS 安全通道”怎么办
这是最常见运行时错误，本质是客户端 TLS 版本不匹配。旧 ASMX 默认只接受 TLS 1.0/1.1，而新版 Windows/.NET 默认禁用这些弱协议。不能改服务端时，必须在调用前显式启用兼容协议。
- 在
Program.cs或Global.asax.cs的Application_Start中加入：System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls | SecurityProtocolType.Tls11;
- 注意：不要写
Tls12—— 多数老服务不支持；也不要用SecurityProtocolType.SystemDefault，它会忽略手动设置 - 如果项目是 ASP.NET Web Forms，确保此行在
Page_Load之前执行（例如放在Global.asax的Application_BeginRequest里）
生成的代理类里方法名带 Async 后缀却没返回 Task 怎么办
ASMX 代理类默认只生成同步方法（如 GetData()）和基于 Begin/End 的异步模式（BeginGetData/EndGetData），不会生成 async/await 友好的 GetDataAsync()。强行加 Async 后缀是误导，实际仍是阻塞调用。
- 若需真正异步，用
Task.Factory.FromAsync包装：var task = Task.Factory.FromAsync<string>(svc.BeginGetData, svc.EndGetData, null);</string>
- 更稳妥的做法是直接用
HttpClient手动发 SOAP 请求（需构造 XML Body、设Content-Type: text/xml、处理 SOAP Action Header），适用于无法修改代理类或需精细控制超时/重试的场景 - 别依赖设计器自动生成的
xxxAsync方法——那是 WCF 的命名习惯，ASMX 代理里它只是普通同步方法的别名
为什么 SoapHeader 传不进去，或者服务端收不到自定义 Header
ASMX 要求自定义 Header 必须继承 SoapHeader，且代理类中对应方法需显式声明 [SoapHeader("YourHeaderName")] 参数。设计器通常不自动映射 Header，需手动补全。
- 先定义 Header 类：
public class AuthHeader : SoapHeader { public string Token; } - 在代理类（
Reference.cs）中找到目标方法，手动添加参数和属性：public string GetData(string id) { ... } → public string GetData(string id, AuthHeader authHeader) { ... }<br>并在方法上加 [SoapHeader("authHeader")] - 调用时必须先 new 实例并赋值：
var svc = new LegacySvc.Service();<br>svc.AuthHeaderValue = new AuthHeader { Token = "abc123" };<br>var result = svc.GetData("123");
旧项目维护中最容易卡在 TLS 协议和 Header 绑定上，这两处没配对，连 WSDL 都拉不下来或请求直接 403。代理类生成后别急着写业务逻辑，先用 Fiddler 抓包看发出的 SOAP 是否含预期 Header、HTTP 状态码是否 200。
