如何在Web.config中为单个API控制器或端点配置location元素

我有一个部署在IIS上的.NET Framework应用，Web.config中包含如下location元素：

...
<location path="Controllers/api">
    <appSettings>
        <add key="secrectMessage" value="myAwesomeValue"/>
    </appSettings>
    <system.web>
        <httpRuntime executionTimeout="300"/>
    </system.web>
</location>
...

其中secretMessage仅用于测试，我真正需要的是配置executionTimeout。我的目标是让该超时设置仅应用于单个API控制器文件，甚至单个端点（如果可行，可将该端点拆分到单独文件）。

使用上述结构时，在IIS管理器中导航到Controllers/api文件夹并查看应用程序设置，能看到secretMessage/myAwesomeValue，但无法在UI中确认executionTimeout是否已设置。

当我将path值改为"Controllers/api/MyController.cs"时，因只能导航到目录，无法在管理器UI中验证设置。为何location元素示例多指向.aspx文件？将路径指向.cs文件是否能生效？能否为控制器内的单个端点指定Web.config设置？

**补充：**我尝试将控制器拆分为两个partial class文件，其中一个放在Controllers/api/extendedTimeout目录以应用配置，在IIS管理器中看似生效，但在该目录下的MyControllerExtension.cs中通过ConfigurationManager.AppSettings["secrectMessage"]取值时返回null。

1. 为何location示例多指向.aspx文件？ #

ASP.NET Web Forms场景下，.aspx是直接对外暴露的请求入口，IIS会直接处理针对这些文件的请求，location路径指向它们时，配置能精准关联到具体请求资源。而MVC/Web API的控制器是通过路由映射到请求的，并非直接以.cs文件作为请求路径，所以传统示例多围绕Web Forms展开。

2. 路径指向.cs文件是否生效？ #

不生效。.cs是后端代码文件，不会被IIS作为直接的请求目标资源，请求是通过路由规则映射到控制器的Action方法，而非直接访问.cs文件。因此location路径指向.cs文件时，IIS无法将配置关联到实际的请求处理流程。

3. 能否为单个端点指定Web.config设置？ #

Web.config的location元素是基于请求URL路径（即路由地址）匹配的，而非代码文件、类或方法。因此无法直接通过location为控制器内的单个Action端点指定配置。

4. partial class拆分后AppSettings取值为null的原因 #

拆分后的partial class本质还是同一个控制器类，运行时它的配置上下文是应用根目录的Web.config，而非代码文件所在目录的配置。MVC/Web API控制器由框架统一实例化，不会因代码文件所在目录不同而加载不同的Web.config。

5. 实现单个控制器/端点超时的可行方案 #

• 代码层面精准设置：在目标Action方法内，直接通过HttpContext.Current.Server.ScriptTimeout = 300;设置超时，仅对当前Action生效，这是最精准的方式。
• 路由匹配location路径：如果目标控制器/端点有独立路由（比如api/longtask），可将location的path设置为该路由路径，此时executionTimeout会应用到所有匹配该路由的请求：

  <location path="api/longtask">
      <system.web>
          <httpRuntime executionTimeout="300"/>
      </system.web>
  </location>
  

• 注意事项：executionTimeout仅在Web.config中debug="false"时生效，且仅针对同步请求，异步请求不受此设置影响。

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