如何将基于Web方法的ASP.NET ASMX Web Service迁移至SoapCore？

1. 基于WebMethod的ASMX能否迁移至SoapCore？ #

可以，但需明确：原ASMX的可交互测试UI是ASP.NET Framework内置asmx处理器提供的功能，SoapCore本身不包含该内置UI——它仅负责托管SOAP服务并暴露WSDL。不过你可通过额外步骤实现等价的交互能力。

迁移核心步骤：

• 提取原ASMX中[WebMethod]对应的业务逻辑，封装为服务接口与实现类
• 用WCF契约特性标记：接口添加[ServiceContract]，每个业务方法添加[OperationContract]（替代原[WebMethod]）
• 复杂参数/返回类型需添加[DataContract]和[DataMember]标记（若原ASMX使用XmlSerializer，SoapCore也支持配置该序列化器）
• 在ASP.NET Core项目中安装SoapCore NuGet包，在Program.cs中配置服务端点：

  builder.Services.AddSoapCore();
  builder.Services.AddSingleton<IMyQuickBooksService, MyQuickBooksService>();
  
  var app = builder.Build();
  app.UseSoapEndpoint<IMyQuickBooksService>("/QuickBooksService.asmx", new SoapEncoderOptions());
  

2. WCF Web Service Reference Provider Tool是否适用？ #

不适用。该工具的作用是生成客户端代理代码，用于调用远程SOAP服务，而非托管服务。如果你需要在.NET Core中托管等价的SOAP服务，这个工具对你的场景没有帮助。

3. 如何实现类似原ASMX的可交互方法UI？ #

因为SoapCore无内置UI，推荐两种方案：

• 方案一：集成Swagger UI展示SOAP服务
  安装Swashbuckle.AspNetCore.Soap NuGet包，配置Swagger以支持SOAP服务，可通过Swagger UI直观查看所有服务方法、输入参数，并发起测试调用。配置示例：

  builder.Services.AddSwaggerGen(c =>
  {
      c.SwaggerDoc("v1", new OpenApiInfo { Title = "QuickBooks SOAP Service", Version = "v1" });
  });
  builder.Services.AddSwaggerSoap();
  
  // ...
  
  app.UseSwagger();
  app.UseSwaggerUI(c =>
  {
      c.SwaggerEndpoint("/swagger/v1/swagger.json", "QuickBooks SOAP Service v1");
  });
  

• 方案二：自定义测试页面
  开发简单的Razor页面或MVC视图，通过反射读取服务契约的OperationContract方法，生成参数输入表单，调用服务后展示返回结果。这种方式更贴近原ASMX的UI风格，但需自行实现元数据读取和调用逻辑。

总结方向 #

• 优先选择SoapCore作为.NET Core下的SOAP服务托管方案，可完整迁移原ASMX的业务逻辑
• 如需可交互测试UI，推荐集成Swagger UI，成本最低且功能完善；若追求原ASMX的UI体验，可自定义测试页面
• 无需考虑WCF Web Service Reference Provider Tool，它是客户端工具，与服务托管无关

内容的提问来源于stack exchange，提问作者James