.NET 8迁移ASMX服务时WSDL中Soap Header为空问题

问题说明 #

将基于.NET Framework 4.8的ASP.NET ASMX Web服务迁移到.NET 8，采用SoapCore v1.2.1实现。目前服务可正常生成WSDL，但SOAP Header部分始终返回空白内容：

<soap:Header/>

现有代码 #

Program.cs #

app.UseSoapEndpoint<IAuthorService>("/Service.asmx", new SoapEncoderOptions());

服务契约 #

using System.Diagnostics;
using System.ServiceModel;
using System.Xml.Linq;

namespace SoapCore_Demo
{
    [ServiceContract]
    public interface IAuthorService
    {
        [OperationContract]
        void MySoapMethod(XElement xml);
    }

    public class AuthorService : IAuthorService
    {
        public AuthHeader objAuth;

        // 原代码存在语法错误，缺少闭合的]，已修正
        [SoapHeader("objAuth", Direction = SoapHeaderDirection.In)]
        public void MySoapMethod(XElement xml)
        {
            Trace.WriteLine(xml.ToString());
        }
    }
}

AuthHeader类（原代码存在语法错误） #

// 原代码语法不完整，存在错误
public class AuthHeader : SoapHeader
public string userName;
public string password;

解决方案 #

1. 修正AuthHeader类定义 #

SoapCore中推荐使用MessageHeader而非传统ASMX的SoapHeader，需完善类定义并指定命名空间，确保WSDL能识别Header结构：

using System.ServiceModel;

public class AuthHeader : MessageHeader
{
    public string UserName { get; set; }
    public string Password { get; set; }

    // 指定Header的名称和命名空间，替换为实际服务的命名空间
    public override string Name => "AuthHeader";
    public override string Namespace => "http://your-service-namespace.com";
}

2. 调整服务实现的Header处理逻辑 #

SoapCore对[SoapHeader]属性的支持需配合额外配置，更可靠的方式是通过行为扩展确保WSDL包含Header元数据：

• 若继续使用[SoapHeader]，需确保SoapCore启用Header解析支持，同时修正原代码的语法错误；
• 实现IContractBehavior或IOperationBehavior，手动向WSDL元数据中添加Header的结构描述，让客户端能识别Header定义。

3. 完善SoapEndpoint配置 #

在Program.cs中启用元数据生成的完整配置，确保Header信息被包含到WSDL中：

var soapEncoderOptions = new SoapEncoderOptions();
app.UseSoapEndpoint<IAuthorService>("/Service.asmx", soapEncoderOptions, enableMetadata: true);

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