如何在ASP.NET 4.8中将ConfigBuilders应用于web.config的system.serviceModel节

根本原因 #

system.serviceModel是WCF框架专属的自定义配置节，其配置处理逻辑未遵循.NET Framework标准配置系统的扩展规则：

• 普通配置节默认继承ConfigurationSection基类的能力，原生支持configBuilders属性，配置系统会自动识别并处理该属性
• WCF的配置处理程序System.ServiceModel.ServiceModelSection为早期独立实现，内部硬编码了允许的属性白名单，未将configBuilders纳入支持范围，因此直接在该节添加属性会触发语法校验错误。

解决方案 #

方案1：全局应用ConfigBuilder（最推荐） #

直接将configBuilders属性添加到根<configuration>节点，全局配置的生成器会作用于所有未显式排除的配置节，包括system.serviceModel。如果存在不需要应用生成器的配置节，单独为这些节添加configBuilders="None"即可。
配置示例如下：

<?xml version="1.0" encoding="utf-8"?>
<!-- 根节点添加configBuilders属性 -->
<configuration configBuilders="EnvironmentExpand">
  <configSections>
    <section name="configBuilders" type="System.Configuration.ConfigurationBuildersSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" restartOnExternalChanges="false" requirePermission="false"/>
  </configSections>

  <configBuilders>
    <builders>
      <add name="EnvironmentExpand" mode="Expand" type="Microsoft.Configuration.ConfigurationBuilders.EnvironmentConfigBuilder, Microsoft.Configuration.ConfigurationBuilders.Environment" />
    </builders>
  </configBuilders>

  <!-- 此处无需添加configBuilders属性，占位符可正常被替换 -->
  <system.serviceModel>
....
  </system.serviceModel>

  <!-- 不需要应用生成器的节显式指定为None -->
  <appSettings configBuilders="None">
    ...
  </appSettings>
</configuration>

方案2：运行时动态修改WCF配置 #

如果不想全局应用ConfigBuilder，可以在应用启动逻辑（如Global.asax的Application_Start方法）中手动读取环境变量，动态替换system.serviceModel节内的占位符，示例代码如下：

using System.Configuration;
using System.ServiceModel.Configuration;

protected void Application_Start(object sender, EventArgs e)
{
    // 读取WCF客户端配置节
    var clientSection = (ClientSection)ConfigurationManager.GetSection("system.serviceModel/client");
    foreach (ChannelEndpointElement endpoint in clientSection.Endpoints)
    {
        // 手动展开环境变量占位符
        string resolvedAddress = Environment.ExpandEnvironmentVariables(endpoint.Address.OriginalString);
        endpoint.Address = new Uri(resolvedAddress);
    }

    // 若为WCF服务端，可修改ServicesSection下的对应配置属性，逻辑同上
}

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