当前位置： 首页 > news >正文

Windows IIS 配置编辑器 应用程序初始化 ＜applicationInitialization＞

news 2025/6/8 8:44:15

概述

        <applicationInitialization> 元素指定在收到请求之前主动执行 Web 应用程序初始化。 如果在接收 HTTP 请求之前执行初始化连接、启动内存缓存、运行查询和编译页面代码等初始化序列，则应用程序可以更快地启动。 应用程序初始化可以在应用程序启动时自动启动初始化过程。 应用程序初始化不一定使初始化过程运行得更快；它更快地启动了这个过程。

        应用程序初始化还使你能够在初始化期间将请求重定向到静态页面（如占位符或闪屏），从而增强用户体验。 加载站点后，它将停止将托管请求映射到静态页面，并开始提供动态内容。 在 <applicationInitialization> 元素中使用 remapManagedRequestsTo 属性时，只能将托管请求映射到单个页面。 但是，应用程序初始化可以与带外 IIS URL 重写模块结合使用，以支持更复杂的占位符内容处理，包括到预先生成的静态内容的复杂映射。

        除了应用程序初始化之外，还可以使初始化过程在应用程序池启动时启动。 将 <application> 元素中的 preLoadEnabled 属性设置为“true”即可。 要发生这种情况，<applicationPool> 元素中的启动模式必须设置为 AlwaysRunning。

兼容性 

版本说明
IIS 10.0<applicationInitialization> 元素在 IIS 10.0 中未进行修改。
IIS 8.5<applicationInitialization> 元素在 IIS 8.5 中未进行修改。
IIS 8.0<applicationInitialization> 元素是在 IIS 8.0 中引入的。
IIS 7.5空值
IIS 7.0空值
IIS 6.0空值

安装

要在 Web 服务器上支持应用程序初始化，必须安装应用程序初始化角色或功能。

Windows Server 2012 或 Windows Server 2012 R2

  1. 在任务栏上，单击 “服务器管理器”。
  2. 在“服务器管理器”中，单击“管理”菜单，然后单击“添加角色和功能”。
  3. 在“添加角色和功能”向导中，单击“下一步”。 选择安装类型，然后单击“下一步”。 选择目标服务器，然后单击“下一步”。
  4. 在“服务器角色”页上，依次展开“Web 服务器 (IIS)”、“Web 服务器”和“应用程序开发”，然后选择“应用程序初始化”。 单击 “下一步” 。

        5.在“选择功能”页上，单击“下一步”。
        6.在“确认安装选择”页上，单击“安装”。
        7.在“结果” 页面中单击“关闭” 。 

Windows 8 或 Windows 8.1

  1. 在“开始”屏幕上，将指针一直移动到左下角，右键单击“开始”按钮，然后单击“控制面板”。
  2. 在“控制面板”中，单击“程序与功能”，然后单击“打开或关闭 Windows 功能”。
  3. 依次展开“Internet Information Services”、“万维网服务”和“应用程序开发功能”，然后选择“应用程序初始化”。

    Screenshot that shows the Windows Features pane. Application Initialization is highlighted and turned on.

  4. 单击“确定”。
  5. 单击“关闭” 。

操作方式

如何配置应用程序初始化

        1、打开 Internet Information Services (IIS) 管理器：

                如果使用 Windows Server 2012 或更高版本：

                        在任务栏上，单击“服务器管理器”，单击“工具”，然后单击“Internet Information Services (IIS)管理器”。

                如果使用的是 Windows 8 或更高版本：

                        按住 Windows 键，按字母 X，然后单击“控制面板”。
                        单击“管理工具”，然后双击“Internet 信息服务(IIS)管理器”。

        2、在“连接”窗格中，选择服务器，展开服务器，展开“站点”，然后选择一个站点。

        3、在“主页”窗格中，双击“配置编辑器”功能。

        4、如果选择了网站，请在“自”文本框中选择“<站点名称> Web.config”，然后在“节”文本框中选择 system.webServer/applicationInitialization。

        5、如果选择服务器，请在“分区”文本框中选择 system.webServer/applicationInitialization。

        6、要指定要在初始化期间返回的静态文件的名称，请将 remapManagedRequestsTo 设置为文件的名称。

        7、如果不想加载托管模块，请将 skipManagedModules 设置为 true。

        8、要指定每当应用程序重启时自动启动初始化过程，请将 doAppInitAfterRestart 设置为 true。

        9、要指定应用程序重新启动时要初始化的应用程序，请单击“(集合)”行，然后单击省略号。

        10、在集合编辑器中，要添加要初始化的应用程序，请单击“添加”，单击“hostName”，然后将 hostName设置为要添加的主机名。 单击 initializationPage 并将其设置为应用程序的 URL。 关闭对话框。

        11、在“操作”窗格中，单击“应用”。

配置

<applicationInitialization> 元素在服务器、站点或应用程序级别配置。

特性

属性说明
doAppInitAfterRestart可选布尔属性。

指定在应用程序重新启动时自动启动初始化过程。 请注意，这不同于应用程序元素中的 preLoadEnabled 属性，后者指定在应用程序池重启后启动初始化过程。

默认值为 false。
remapManagedRequestsTo可选的字符串属性。

指定在应用程序初始化期间要将请求重新映射到的页。

默认值为 ""。
skipManagedModules可选布尔属性。

指定在初始化期间是否加载托管模块，false 表示加载，true 表示不加载。

默认值为 false。

子元素

元素说明
add可选元素。

指定要在应用程序重启时初始化的应用程序。

配置示例

以下示例演示应用程序初始化的配置。

<system.webServer>
   <applicationInitialization
      doAppInitAfterRestart="true"
      skipManagedModules="true"
      remapManagedRequestsTo="filename.htm">
      <add initializationPage="/default.aspx" hostName="myhost"/>
   </applicationInitialization>
</system.webServer> 

代码示例

以下示例为站点配置 <applicationInitialization>。

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/applicationInitialization /remapManagedRequestsTo:"HelloJoe.htm" /skipManagedModules:"True" /doAppInitAfterRestart:"True"  /commit:apphost

appcmd.exe set config "Default Web Site" -section:system.webServer/applicationInitialization /+"[initializationPage='JoesSite.htm',hostName='JoesHost']" /commit:apphost

 备注

        使用 AppCmd.exe 配置这些设置时，必须确保将 commit 参数设置为 apphost。 这会将配置设置提交到 ApplicationHost.config 文件中的相应位置部分。

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample {

    private static void Main() {
        
        using(ServerManager serverManager = new ServerManager()) { 
            Configuration config = serverManager.GetApplicationHostConfiguration();
            
            ConfigurationSection applicationInitializationSection = config.GetSection("system.webServer/applicationInitialization", "Default Web Site");
            applicationInitializationSection["remapManagedRequestsTo"] = @"HelloJoe.htm";
            applicationInitializationSection["skipManagedModules"] = true;
            applicationInitializationSection["doAppInitAfterRestart"] = true;
            
            ConfigurationElementCollection applicationInitializationCollection = applicationInitializationSection.GetCollection();
            
            ConfigurationElement addElement = applicationInitializationCollection.CreateElement("add");
            addElement["initializationPage"] = @"JoesSite.htm";
            addElement["hostName"] = @"JoesHost";
            applicationInitializationCollection.Add(addElement);
            
            serverManager.CommitChanges();
        }
    }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration
Module Sample
     
     Sub Main()
         Dim serverManager As ServerManager = New ServerManager
         Dim config As Configuration = serverManager.GetApplicationHostConfiguration
         Dim applicationInitializationSection As ConfigurationSection = config.GetSection("system.webServer/applicationInitialization", "Default Web Site")
         applicationInitializationSection("remapManagedRequestsTo") = "HelloJoe.htm"
         applicationInitializationSection("skipManagedModules") = true
         applicationInitializationSection("doAppInitAfterRestart") = true
         Dim applicationInitializationCollection As ConfigurationElementCollection = applicationInitializationSection.GetCollection
         Dim addElement As ConfigurationElement = applicationInitializationCollection.CreateElement("add")
         addElement("initializationPage") = "JoesSite.htm"
         addElement("hostName") = "JoesHost"
         applicationInitializationCollection.Add(addElement)
         serverManager.CommitChanges
     End Sub
 End Module 

JavaScript 

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var applicationInitializationSection = adminManager.GetAdminSection("system.webServer/applicationInitialization", "MACHINE/WEBROOT/APPHOST/Default Web Site");
applicationInitializationSection.Properties.Item("remapManagedRequestsTo").Value = "HelloJoe.htm";
applicationInitializationSection.Properties.Item("skipManagedModules").Value = true;
applicationInitializationSection.Properties.Item("doAppInitAfterRestart").Value = true;

var applicationInitializationCollection = applicationInitializationSection.Collection;

var addElement = applicationInitializationCollection.CreateNewElement("add");
addElement.Properties.Item("initializationPage").Value = "JoesSite.htm";
addElement.Properties.Item("hostName").Value = "JoesHost";
applicationInitializationCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set applicationInitializationSection = adminManager.GetAdminSection("system.webServer/applicationInitialization", "MACHINE/WEBROOT/APPHOST/Default Web Site")
applicationInitializationSection.Properties.Item("remapManagedRequestsTo").Value = "HelloJoe.htm"
applicationInitializationSection.Properties.Item("skipManagedModules").Value = true
applicationInitializationSection.Properties.Item("doAppInitAfterRestart").Value = true

Set applicationInitializationCollection = applicationInitializationSection.Collection

Set addElement = applicationInitializationCollection.CreateNewElement("add")
addElement.Properties.Item("initializationPage").Value = "JoesSite.htm"
addElement.Properties.Item("hostName").Value = "JoesHost"
applicationInitializationCollection.AddElement(addElement)

adminManager.CommitChanges()

PowerShell

Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -location 'Default Web Site' -filter "system.webServer/applicationInitialization" -name "remapManagedRequestsTo" -value "HelloJoe.htm"
Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -location 'Default Web Site' -filter "system.webServer/applicationInitialization" -name "skipManagedModules" -value "True"
Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -location 'Default Web Site' -filter "system.webServer/applicationInitialization" -name "doAppInitAfterRestart" -value "True"

Add-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -location 'Default Web Site' -filter "system.webServer/applicationInitialization" -name "." -value @{initializationPage='JoesSite.htm';hostName='JoesHost'}

参考文章：应用程序初始化 <applicationInitialization> | Microsoft Learn

配置参考<配置> | Microsoft Learn

如果您喜欢此文章，请收藏、点赞、评论，谢谢，祝您快乐每一天。 

http://www.xdnf.cn/news/112537.html

相关文章：

  • 开发并发布一个属于自己的包（npm）
  • 算法笔记.spfa算法(bellman-ford算法的改进)
  • 要从给定的数据结构中提取所有的 itemList 并将其放入一个新的数组中
  • Python爬虫（3）HTML核心技巧：从零掌握class与id选择器，精准定位网页元素
  • mfc学习（一）
  • 基于whisper和ffmpeg语音转文本小程序
  • 【深度学习】#9 现代循环神经网络
  • 【C++】继承
  • 数据结构与算法实战：从理论到落地的深度探索
  • 原生微信小程序，canvas生成凭证，保存到手机
  • Java的进阶学习
  • 鲲鹏麒麟搭建Docker仓库
  • 海量聊天消息处理：ShardingJDBC分库分表、ClickHouse冷热数据分离、ES复合查询方案、Flink实时计算与SpringCloud集成
  • C++ RPC以及cmake
  • VBA技术资料MF300：利用Mid进行文本查找
  • 专家系统的一般结构解析——基于《人工智能原理与方法》的深度拓展
  • JBoltAI 赋能金融文档：基于 RAG 的基金招募说明书视觉增强方案
  • 分布式微服务架构,数据库连接池设计策略
  • 【框架学习】Spring AI-功能学习与实战（一）
  • node.js 实战——（Http 知识点学习）
  • 使用PyTorch如何配置一个简单的GTP
  • Framework.jar里的类无法通过Class.forName反射某个类的问题排查
  • FPGA上实现YOLOv5的一般过程
  • 机器学习特征工程中的数值分箱技术：原理、方法与实例解析
  • 看一看 中间件Middleware
  • mapbox高阶，高程影像、行政区边界阴影效果实现
  • 开源项目实战学习之YOLO11：ultralytics-cfg-datasets-lvis.yaml文件（五）
  • 长城杯铁人三项初赛-REVERSE复现
  • Linux常见指令介绍下（入门级）
  • 手搓雷达图（MATLAB）