PartialCachingAttribute Конструкторы

Определение

Инициализирует новый экземпляр класса PartialCachingAttribute.

Перегрузки

PartialCachingAttribute(Int32)

Initializes a new instance of the 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)

Initializes a new instance of the 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", то кэш изменяется в соответствии с именем и версией браузера. Если вводится пользовательская строка, необходимо переопределить метод GetVaryByCustomString(HttpContext, String) в файле Global.asax приложения.

Примеры

В следующем примере кода показано, как 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", то кэш изменяется в соответствии с именем и версией браузера. Если вводится пользовательская строка, необходимо переопределить метод GetVaryByCustomString(HttpContext, String) в файле Global.asax приложения.

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", то кэш изменяется в соответствии с именем и версией браузера. Если вводится пользовательская строка, необходимо переопределить метод GetVaryByCustomString(HttpContext, String) в файле Global.asax приложения.

sqlDependency
String

Список с разделителями имен баз данных и таблиц, при изменении которого явно заканчивается время хранения кэша ASP.NET. Эти имена баз данных соответствуют зависимостям кэша SQL Server в вашем разделе конфигурации Интернета.

shared
Boolean

true, если выходной поток пользовательского элемента управления разделяем несколькими страницами; в противном случае — false.

Применяется к