ASP+頁緩衝OutputCache Duration用法

聲明的方式控制   ASP.NET   頁或頁中包含的使用者控制項的輸出緩衝策略。有關輸出緩衝的更多資訊，請參見   ASP.NET   緩衝功能。  
   
  <%@   OutputCache   Duration="#ofseconds"   Location="Any   |   Client   |   Downstream   |   Server   |   None"   Shared="True   |   False"   VaryByControl="controlname"   VaryByCustom="browser   |   customstring"   VaryByHeader="headers"   VaryByParam="parametername"   %>  
  屬性  
  Duration    
  頁或使用者控制項進行緩衝的時間（以秒計）。在頁或使用者控制項上設定該屬性為來自對象的   HTTP   響應建立了一個到期策略，並將自動快取頁面或使用者控制項輸出。    
  注意       該屬性是必需的。如果未包含該屬性，將出現分析器錯誤。  
  Location    
  OutputCacheLocation   枚舉值之一。預設值為   Any。    
  警告       包含在使用者控制項（.ascx   檔案）中的   @   OutputCache   指令不支援此屬性。  
  Shared    
  一個布爾值，確定使用者控制項輸出是否可以由多個頁共用。預設值為   false。有關詳細資料，請參見備忘部分。    
  注意       包含在   ASP.NET   頁（.aspx   檔案）中的   @   OutputCache   指令不支援此屬性。  
  VaryByCustom    
  表示自訂輸出緩衝要求的任意文本。如果賦予該屬性的值是   browser，緩衝將隨瀏覽器名稱和主要版本資訊的不同而不同。如果輸入了自訂字串，您必須在應用程式的   Global.asax   檔案中重寫   HttpApplication.GetVaryByCustomString   方法。    
  VaryByHeader    
  分號分隔的   HTTP   標題列表，用於使輸出緩衝發生變化。當將該屬性設為多標題時，對於每個指定的標題，輸出緩衝都包含一個請求文檔的不同版本。    
  注意       設定   VaryByHeader   屬性在所有   HTTP   1.1   緩衝中啟用快取項目，而不僅限於   ASP.NET   緩衝。使用者控制項中的   @   OutputCache   指令不支援此屬性。  
  VaryByParam    
  分號分隔的字串列表，用於使輸出緩衝發生變化。預設情況下，這些字串與用   GET   方法屬性發送的查詢字串值對應，或與用   POST   方法發送的參數對應。當將該屬性設定為多參數時，對於每個指定的參數，輸出緩衝都包含一個請求文檔的不同版本。可能的值包括   none、*   和任何有效查詢字串或   POST   參數名稱。    
  警告       在輸出緩衝   ASP.NET   頁時，該屬性是必需的。它對於使用者控制項也是必需的，除非已經在使用者控制項的   @   OutputCache   指令中包含了   VaryByControl   屬性。如果沒有包含它，則發生分析器錯誤。如果您不想使緩衝內容隨任何指定參數發生變化，請將該值設為   none。如果要使輸出緩衝根據所有參數值發生變化，請將屬性設定為   *。  
  VaryByControl    
  一個分號分隔的字串列表，用於更改使用者控制項的輸出緩衝。這些字串代表在使用者控制項中聲明的   ASP.NET   伺服器控制項的   ID   屬性值。有關詳細資料，請參見緩衝   ASP.NET   頁的某些部分。    
  注意       除非已經包含了   VaryByParam   屬性，否則在使用者控制項   @   OutputCache   指令中，該屬性是必需的。ASP.NET   頁中的   @   OutputCache   指令不支援該屬性。  
  備忘  
  為頁輸出緩衝設定值與通過   HttpResponse.Cache   屬性操作   HttpCachePolicy.SetExpires   和   HttpCachePolicy.SetCacheability   方法相同。如果在建立使用者控制項時設定   VaryByParam   屬性，可實現該控制項的部分頁緩衝。  
   
  如果   Web   表單頁要求使用者查看授權，則輸出緩衝將   Cache-Control   HTTP   標題設定為   private。有關所有這些主題的詳細資料，請參見緩衝   ASP.NET   頁。  
   
  如果將   Shared   屬性設定為   true，則緩衝的使用者控制項輸出可以被多個   Web   表單頁訪問。如果不設定為   true，預設行為是為包含使用者控制項的每一頁緩衝使用者控制項輸出的一個版本。通過啟用   Shared   屬性，可以潛在地節省大量的記憶體。有關詳細資料，請參見緩衝   ASP.NET   頁的某些部分。  
   
  樣本  
  下面的樣本說明了如何設定頁或使用者控制項進行輸出緩衝的期間。  
   
  <%@   OutputCache   Duration="100"   VaryByParam="none"   %>  
  下一個樣本說明了如何指示輸出緩衝來對頁或使用者控制項進行緩衝，此緩衝處理是根據來自表單的   POST   或來自查詢字串的位置和計數表單參數進行的。每個收到的具有不同位置或計數參數（或兩者）的   HTTP   請求都進行   10   秒的緩衝處理。帶有相同參數值的任何後繼請求都將從緩衝中得到滿足，直至超過輸入的緩衝期。  
   
  <%@   OutputCache   Duration="100"   VaryByParam="location;count"   %>