PartialCachingAttribute 建構函式

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

初始化 PartialCachingAttribute 類別的新執行個體。

多載

PartialCachingAttribute(Int32)	使用指派給要快取的使用者控制項持續期間，初始化 PartialCachingAttribute 類別的新執行個體。
PartialCachingAttribute(Int32, String, String, String)	初始化 PartialCachingAttribute 類別的新執行個體，並指定快取期間、任何的 GET 和 POST 值、控制項名稱以及用來變更快取的自訂輸出快取需求。
PartialCachingAttribute(Int32, String, String, String, Boolean)	初始化 PartialCachingAttribute 類別的新執行個體，並指定快取期間、任何的 GET 和 POST 值、控制項名稱、用來變更快取的自訂輸出快取需求，以及使用者控制項輸出是否可以與多個頁面共用。
PartialCachingAttribute(Int32, String, String, String, String, Boolean)	初始化 PartialCachingAttribute 類別的新執行個體，並指定快取期間、任何的 GET 和 POST 值、控制項名稱、用來變更快取的自訂輸出快取需求、資料庫相依性，以及使用者控制項輸出是否可以與多個頁面共用。

PartialCachingAttribute(Int32)

使用指派給要快取的使用者控制項持續期間，初始化 PartialCachingAttribute 類別的新執行個體。

public:
 PartialCachingAttribute(int duration);

public PartialCachingAttribute (int duration);

new System.Web.UI.PartialCachingAttribute : int -> System.Web.UI.PartialCachingAttribute

Public Sub New (duration As Integer)

參數

duration

Int32

使用者控制項應停留在輸出快取區中的時間 (以秒為單位)。

範例

下列程式碼範例示範如何將建 PartialCachingAttribute(Int32) 構函式套用至使用者控制項。 在此範例中，建構函式用來指出可以快取使用者控制項，以及指定快取持續時間。 此程式碼範例是提供給 類別之較大範例的 PartialCachingAttribute 一部分。

// Set the PartialCachingAttribute.Duration property to 20 seconds.
[PartialCaching(20)]
public partial class ctlMine : UserControl

' Set the PartialCachingAttribute.Duration property to 20 seconds.
<PartialCaching(20)> _
Partial Class ctlMine
    Inherits UserControl

PartialCachingAttribute(Int32, String, String, String)

初始化 PartialCachingAttribute 類別的新執行個體，並指定快取期間、任何的 GET 和 POST 值、控制項名稱以及用來變更快取的自訂輸出快取需求。

public:
 PartialCachingAttribute(int duration, System::String ^ varyByParams, System::String ^ varyByControls, System::String ^ varyByCustom);

public PartialCachingAttribute (int duration, string varyByParams, string varyByControls, string varyByCustom);

new System.Web.UI.PartialCachingAttribute : int * string * string * string -> System.Web.UI.PartialCachingAttribute

Public Sub New (duration As Integer, varyByParams As String, varyByControls As String, varyByCustom As String)

參數

duration

Int32

快取使用者控制項的時間長度，以秒為單位。

varyByParams

String

用來變更輸出快取的分號分隔的字串清單。 根據預設值，這些字串會對應至以 GET 方法屬性所傳送的查詢字串值，或對應至使用 POST 方法所傳送的參數。 當這個屬性被設定為多個參數時，輸出快取會包含每一指定參數所要求文件的不同版本。 可能的值包括 "none"、"*"，以及任何有效的查詢字串，或 POST 參數名稱。

varyByControls

String

用來變更輸出快取的分號分隔的字串清單。 這些字串是表示使用者控制項上屬性的完整名稱。 當這個參數使用於使用者控制項時，使用者控制項輸出會針對每一個指定使用者控制項屬性的快取而改變。

varyByCustom

String

表示自訂輸出快取需求的任何文字。 如果這個參數取得 "browser" 的值設，則快取會根據瀏覽器名稱和主要版本資訊而有所不同。 如果自訂字串已輸入，則您必須在您應用程式的 Global.asax 檔中覆寫 GetVaryByCustomString(HttpContext, String) 方法。

範例

下列程式碼範例示範如何將建 PartialCachingAttribute(Int32, String, String, String) 構函式套用至使用者控制項。 在此範例中，建構函式用來指出可以快取使用者控制項、將快取持續時間指定為 20 秒，並指定名為 state 的控制項，其中使用者控制項輸出將會有所不同。

// Set the PartialCachingAttribute.Duration property to
// 20 seconds and the PartialCachingAttribute.VaryByControls
// property to the ID of the server control to vary the output by.
// In this case, it is state, the ID assigned to a DropDownList
// server control.
[PartialCaching(20, null, "state", null)]

' Set the PartialCachingAttribute.Duration property to
' 20 seconds and the PartialCachingAttribute.VaryByControls
' property to the ID of the server control to vary the output by.
' In this case, it is state, the ID assigned to a DropDownList
' server control.
<PartialCaching(20, Nothing, "state", Nothing)> _
Public Class ctlSelect
    Inherits UserControl

PartialCachingAttribute(Int32, String, String, String, Boolean)

初始化 PartialCachingAttribute 類別的新執行個體，並指定快取期間、任何的 GET 和 POST 值、控制項名稱、用來變更快取的自訂輸出快取需求，以及使用者控制項輸出是否可以與多個頁面共用。

public:
 PartialCachingAttribute(int duration, System::String ^ varyByParams, System::String ^ varyByControls, System::String ^ varyByCustom, bool shared);

public PartialCachingAttribute (int duration, string varyByParams, string varyByControls, string varyByCustom, bool shared);

new System.Web.UI.PartialCachingAttribute : int * string * string * string * bool -> System.Web.UI.PartialCachingAttribute

Public Sub New (duration As Integer, varyByParams As String, varyByControls As String, varyByCustom As String, shared As Boolean)

參數

duration

Int32

快取使用者控制項的時間長度，以秒為單位。

varyByParams

String

用來變更輸出快取的分號分隔的字串清單。 根據預設值，這些字串對應至使用 GET 方法屬性傳送的查詢字串值或使用 POST 方法傳送的參數。 當這個屬性被設定為多個參數時，輸出快取會包含每一指定參數所要求文件的不同版本。 可能的值包括 "none"、"*" 以及任何有效的查詢字串，或 POST 參數名稱。

varyByControls

String

用來變更輸出快取的分號分隔的字串清單。 這些字串是表示使用者控制項上屬性的完整名稱。 當這個參數使用於使用者控制項時，使用者控制項輸出會針對每一個指定使用者控制項屬性的快取而改變。

varyByCustom

String

表示自訂輸出快取需求的任何文字。 如果這個參數取得 "browser" 的值設，則快取會根據瀏覽器名稱和主要版本資訊而有所不同。 如果自訂字串已輸入，則您必須在您應用程式的 Global.asax 檔中覆寫 GetVaryByCustomString(HttpContext, String) 方法。

shared

Boolean

若為 true，表示使用者控制項輸出可以與多個頁面共用，否則為 false。

PartialCachingAttribute(Int32, String, String, String, String, Boolean)

初始化 PartialCachingAttribute 類別的新執行個體，並指定快取期間、任何的 GET 和 POST 值、控制項名稱、用來變更快取的自訂輸出快取需求、資料庫相依性，以及使用者控制項輸出是否可以與多個頁面共用。

public:
 PartialCachingAttribute(int duration, System::String ^ varyByParams, System::String ^ varyByControls, System::String ^ varyByCustom, System::String ^ sqlDependency, bool shared);

public PartialCachingAttribute (int duration, string varyByParams, string varyByControls, string varyByCustom, string sqlDependency, bool shared);

new System.Web.UI.PartialCachingAttribute : int * string * string * string * string * bool -> System.Web.UI.PartialCachingAttribute

Public Sub New (duration As Integer, varyByParams As String, varyByControls As String, varyByCustom As String, sqlDependency As String, shared As Boolean)

參數

duration

Int32

快取使用者控制項的時間長度，以秒為單位。

varyByParams

String

用來變更輸出快取的分號分隔的字串清單。 根據預設值，這些字串對應至使用 GET 方法屬性傳送的查詢字串值或使用 POST 方法傳送的參數。 當這個屬性被設定為多個參數時，輸出快取會包含每一指定參數所要求文件的不同版本。 可能的值包括 "none"、"*" 以及任何有效的查詢字串，或 POST 參數名稱。

varyByControls

String

用來變更輸出快取的分號分隔的字串清單。 這些字串是表示使用者控制項上屬性的完整名稱。 當這個參數使用於使用者控制項時，使用者控制項輸出會針對每一個指定使用者控制項屬性的快取而改變。

varyByCustom

String

表示自訂輸出快取需求的任何文字。 如果這個參數取得 "browser" 的值設，則快取會根據瀏覽器名稱和主要版本資訊而有所不同。 如果自訂字串已輸入，則您必須在您應用程式的 Global.asax 檔中覆寫 GetVaryByCustomString(HttpContext, String) 方法。

sqlDependency

String

在變更資料庫名稱和表格名稱的分隔清單時，明確地讓 ASP.NET 快取中的快取項目到期。 這些資料庫名稱會符合 Web 組態區段中所識別的 SQL Server 快取相依性。

shared

Boolean

若為 true，表示使用者控制項輸出可以與多個頁面共用，否則為 false。