共用方式為


應用程式初始化 < 應用程式初始化應用程式初始化>

概觀

元素 <applicationInitialization> 指定在收到要求之前主動執行 Web 應用程式初始化。 如果初始化連線、啟動記憶體內部快取、執行查詢和編譯頁面程式碼等初始化順序,應用程式可以在收到 HTTP 要求之前更快速地啟動。 每當應用程式啟動時,應用程式初始化都可以自動啟動初始化程式。 應用程式初始化不一定會讓初始化程式執行得更快;它會更快啟動程式。

應用程式初始化也可讓您藉由將要求重新導向至靜態頁面,例如預留位置或啟動顯示畫面,來增強初始化期間的使用者體驗。 載入網站之後,它會停止將 Managed 要求對應至靜態頁面,並開始提供動態內容。 在 元素中使用 <applicationInitialization>remapManagedRequestsTo屬性時,您只能將 Managed 要求對應至單一頁面。 不過,應用程式初始化可以與頻外 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 N/A
IIS 7.0 N/A
IIS 6.0 N/A

安裝程式

若要在 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]、[ 萬維網服務]、[ 應用程式開發功能],然後選取 [ 應用程式初始化]。
    顯示 [Windows 功能] 窗格的螢幕擷取畫面。應用程式初始化會反白顯示並開啟。
  4. 按一下 [確定]。
  5. 按一下 [關閉] 。

作法

如何設定應用程式初始化

  1. (IIS) 管理員開啟 Internet Information Services

    • 如果您使用 Windows Server 2012 或更新版本:

      • 在工作列上,依序按一下 [伺服器管理員]、[工具],然後按一下 [Internet Information Services] ([IIS) 管理員]。
    • 如果您使用 Windows 8 或更新版本:

      • 按住Windows鍵,按字母X,然後按一下[主控台]。
      • 按一下 [ 系統管理工具],然後按兩下 [Internet Information Services] ([IIS) 管理員]。
  2. 在 [ 連線 ] 窗格中,選取伺服器,或展開伺服器、展開 [站台],然後選取月臺。

  3. 在 [ 首頁] 窗格中,按兩下 [ 組態編輯器 ] 功能。

  4. 如果您選取網站,請在 [] 文字方塊中選取< [網站名稱 > ] Web.config,然後在 [區段] 文字方塊中選取system.webServer/applicationInitialization

  5. 如果您選取伺服器,請在 [區段] 文字方塊中選取system.webServer/applicationInitialization

    顯示 [組態編輯器] 窗格的螢幕擷取畫面。集合已醒目提示。

  6. 若要指定要在初始化期間傳回的靜態檔案名,請將 remapManagedRequestsTo 設定為檔案名。

  7. 如果您不想載入 Managed 模組,請將 skipManagedModules 設定為 true

  8. 若要指定每當應用程式重新開機時自動起始初始化程式, 請將 doAppInitAfterRestart 設定為 true

  9. 若要指定要在應用程式重新開機時初始化的應用程式,請按一下 (集合) 行,然後按一下省略號。

  10. 在 [集合編輯器] 中,若要新增要初始化的應用程式,請按一下 [ 新增],按一下 [hostName],然後將 hostName 設定為主機名。 按一下 [初始化][頁面 ],並將其設定為應用程式的 URL。 關閉對話方塊。

    顯示 [集合編輯器] 窗格的螢幕擷取畫面。主機名稱會在 [屬性] 方塊中反白顯示。

  11. 在 [動作] 窗格中按一下 [套用]

組態

專案 <applicationInitialization> 是在伺服器、月臺或應用層級設定。

屬性

屬性 描述
doAppInitAfterRestart 選擇性的 Boolean 屬性。

指定每當應用程式重新開機時,就會自動起始初始化進程。 請注意,這與應用程式元素中的 preLoadEnabled 屬性不同,這會指定初始化程式是在應用程式集區重新開機之後啟動。

預設值是 false
remapManagedRequestsTo 選擇性字串屬性。

指定要在應用程式初始化期間重新對應要求的頁面。

預設值是 ""
skipManagedModules 選擇性的 Boolean 屬性。

指定受控模組是在初始化期間載入 (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 來設定這些設定時,您必須確定將 認可 參數 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'}