ASP.NET C#中如何自定义Web Service/SOAP调用生成的XML？

嘿，我之前在ASP.NET C#项目里刚好碰到过一模一样的问题——自动生成的XML不兼容的时候真的头大。下面给你拆解所有能自定义Web Service调用生成XML（包括SOAP消息）的方法，不管你是自己写服务端还是调用第三方服务都能用：

一、如果你是开发Web Service服务端，要自定义输出的XML #

方法1：用内置序列化属性（最简单的轻量方案） #

.NET提供了一系列XML序列化属性，不用写复杂代码就能调整XML结构，覆盖大部分常见需求：

• 重命名元素/属性：用[XmlElement("自定义元素名")]、[XmlAttribute("自定义属性名")]
• 修改根节点：在实体类上标注[XmlRoot("自定义根节点名")]
• 忽略字段：用[XmlIgnore]跳过不需要序列化的属性
• 指定命名空间：在WebMethod上加[WebMethod(Namespace = "http://your.custom.namespace")]，或者在类上用[XmlNamespaceDeclarations]

示例代码：

[XmlRoot("用户信息")]
public class User
{
    [XmlElement("用户名")]
    public string Name { get; set; }

    [XmlAttribute("年龄")]
    public int Age { get; set; }

    [XmlIgnore]
    public string Password { get; set; } // 这个字段不会出现在XML里
}

[WebService(Namespace = "http://your.company.ns")]
public class UserService : WebService
{
    [WebMethod]
    public User GetUserInfo(int userId)
    {
        return new User { Name = "张三", Age = 28 };
    }
}

生成的XML会完全按照你标注的属性来结构。

方法2：实现IXmlSerializable接口（完全自定义XML结构） #

如果内置属性满足不了复杂的XML需求（比如嵌套特殊节点、动态生成元素），可以实现这个接口，手动写序列化/反序列化逻辑：

示例代码：

public class CustomOrder : IXmlSerializable
{
    public string OrderId { get; set; }
    public decimal Amount { get; set; }

    public XmlSchema GetSchema() => null;

    // 自定义反序列化（从XML读取数据）
    public void ReadXml(XmlReader reader)
    {
        reader.ReadStartElement("订单");
        OrderId = reader.ReadElementString("订单编号");
        Amount = decimal.Parse(reader.ReadElementString("订单金额"));
        reader.ReadEndElement();
    }

    // 自定义序列化（生成XML）
    public void WriteXml(XmlWriter writer)
    {
        writer.WriteElementString("订单编号", OrderId);
        writer.WriteElementString("订单金额", Amount.ToString("F2"));
        // 还能加自定义节点
        writer.WriteElementString("下单时间", DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"));
    }
}

WebService返回这个类时，输出的XML就是你在WriteXml里定义的结构，完全可控。

方法3：自定义SOAP扩展（修改整个SOAP信封） #

如果要修改SOAP消息的整体结构（比如添加自定义Header、修改Envelope命名空间、统一加节点），可以用SOAP扩展：

1. 继承SoapExtension类，重写核心方法：

public class CustomSoapExtension : SoapExtension
{
    private Stream _oldStream;
    private Stream _newStream;

    public override Stream ChainStream(Stream stream)
    {
        _oldStream = stream;
        _newStream = new MemoryStream();
        return _newStream;
    }

    public override void ProcessMessage(SoapMessage message)
    {
        switch (message.Stage)
        {
            case SoapMessageStage.AfterSerialize:
                // 序列化完成后修改XML
                _newStream.Position = 0;
                XmlDocument doc = new XmlDocument();
                doc.Load(_newStream);
                
                // 示例：给SOAP Envelope加自定义命名空间
                doc.DocumentElement.SetAttribute("xmlns:custom", "http://your.custom.ns");
                
                // 把修改后的XML写回原流
                _newStream.SetLength(0);
                doc.Save(_newStream);
                _newStream.Position = 0;
                CopyStream(_newStream, _oldStream);
                break;
            // 其他阶段（BeforeSerialize/BeforeDeserialize）可以按需处理
        }
    }

    private void CopyStream(Stream from, Stream to)
    {
        using var reader = new StreamReader(from);
        using var writer = new StreamWriter(to);
        writer.Write(reader.ReadToEnd());
        writer.Flush();
    }

    // 需实现GetInitializer和Initialize方法，这里省略（可参考官方文档补全）
}

2. 在Web.config里注册扩展：

<system.web>
  <webServices>
    <soapExtensionTypes>
      <add type="你的命名空间.CustomSoapExtension, 你的程序集名称" priority="1" group="0"/>
    </soapExtensionTypes>
  </webServices>
</system.web>

二、如果你是调用第三方Web Service的客户端，要修改发送的SOAP请求XML #

方法1：手动构造SOAP XML，用HttpWebRequest发送 #

放弃自动生成的代理类，完全自己控制请求内容：

// 自定义构造符合要求的SOAP XML
string soapRequest = @"<?xml version=""1.0"" encoding=""utf-8""?>
<soap:Envelope xmlns:soap=""http://schemas.xmlsoap.org/soap/envelope/"">
  <soap:Body>
    <GetUser xmlns=""http://thirdparty.ns"">
      <UserId>123</UserId>
    </GetUser>
  </soap:Body>
</soap:Envelope>";

// 发送请求
var request = (HttpWebRequest)WebRequest.Create("http://第三方服务地址");
request.Method = "POST";
request.ContentType = "text/xml; charset=utf-8";
request.Headers.Add("SOAPAction", "\"http://thirdparty.ns/GetUser\"");

using var writer = new StreamWriter(request.GetRequestStream());
writer.Write(soapRequest);

// 处理响应
using var response = (HttpWebResponse)request.GetResponse();
using var reader = new StreamReader(response.GetResponseStream());
string responseXml = reader.ReadToEnd();

方法2：修改自动生成的代理类 #

如果还想用代理类的便捷性，可以继承代理类，重写GetWebRequest方法来修改请求XML：

// 假设自动生成的代理类是ThirdPartyService
public class CustomThirdPartyService : ThirdPartyService
{
    protected override WebRequest GetWebRequest(Uri uri)
    {
        var request = (HttpWebRequest)base.GetWebRequest(uri);
        
        // 读取原请求的SOAP XML，修改后重新写入
        request.GetRequestStream().Position = 0;
        using var sr = new StreamReader(request.GetRequestStream());
        string soapXml = sr.ReadToEnd();
        
        // 示例：替换XML里的某个节点值
        soapXml = soapXml.Replace("<OldParam>默认值</OldParam>", "<NewParam>自定义值</NewParam>");
        
        // 重新写入修改后的XML
        request.ContentLength = soapXml.Length;
        using var sw = new StreamWriter(request.GetRequestStream());
        sw.Write(soapXml);
        sw.Flush();
        
        return request;
    }
}

之后用CustomThirdPartyService调用方法，发送的SOAP请求就是修改后的内容。

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