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。