PartialCachingAttribute Конструкторы
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр класса PartialCachingAttribute.
Перегрузки
| Имя. | Описание |
|---|---|
| PartialCachingAttribute(Int32) |
Инициализирует новый экземпляр 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)
Инициализирует новый экземпляр 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в противном случае .