将ASMX Web方法迁移至WCF：字符串数组参数无法接收问题求助

问题原因 #

ASMX服务默认采用XmlSerializer并使用SoapParameterStyle.Wrapped的参数包装风格，而WCF默认使用DataContractSerializer且参数风格为Bare，两者的SOAP消息结构不匹配，导致原有客户端发送的数组参数无法被WCF正确解析。

解决方案 #

通过调整WCF的序列化配置和操作契约属性，让WCF兼容ASMX的消息格式，无需修改客户端代码：

1. 修改服务接口配置 #

给接口添加XmlSerializerFormat特性，并为操作契约指定匹配ASMX的SOAP参数风格：

[ServiceContract(Namespace = "http://example.com/Report")]
[XmlSerializerFormat] // 切换至ASMX同款XmlSerializer序列化器
public interface IReport
{
    [OperationContract(Action = "http://example.com/Report/Save", 
                       ReplyAction = "http://example.com/Report/SaveResponse")]
    [SoapDocumentMethod(Action = "http://example.com/Report/Save", 
                        ParameterStyle = SoapParameterStyle.Wrapped, // 匹配ASMX的参数包装方式
                        Use = SoapBindingUse.Literal)]
    void Save(string name, string[] skills);
}

2. 配置服务绑定 #

确保使用basicHttpBinding（对应ASMX的SOAP 1.1协议），在web.config或app.config中添加如下配置：

<system.serviceModel>
  <services>
    <service name="YourNamespace.Report">
      <endpoint address="" 
                binding="basicHttpBinding" 
                contract="YourNamespace.IReport"/>
    </service>
  </services>
</system.serviceModel>

原理说明 #

• XmlSerializerFormat：让WCF使用与ASMX完全一致的XmlSerializer进行序列化/反序列化，保证SOAP消息结构兼容。
• SoapDocumentMethod：指定参数采用Wrapped风格，即所有参数被包裹在与操作同名的XML元素中，这和ASMX的默认请求结构完全匹配。
• basicHttpBinding：提供SOAP 1.1协议支持，与ASMX服务的通信协议完全兼容，无需客户端做任何调整。

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