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, определяющий длительность кэширования, любые значения |
PartialCachingAttribute(Int32, String, String, String, String, Boolean) |
Инициализирует новый экземпляр класса PartialCachingAttribute, определяющий длительность кэширования, любые значения |
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
.