PartialCachingAttribute Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe PartialCachingAttribute.
Sobrecargas
PartialCachingAttribute(Int32) |
Inicializa uma nova instância da classe PartialCachingAttribute com a duração especificada atribuída ao controle de usuário a ser armazenado em cache. |
PartialCachingAttribute(Int32, String, String, String) |
Inicializa uma nova instância da classe PartialCachingAttribute, que especifica a duração do cache, qualquer valor GET e POST, nomes de controle e requisitos de cache de saída personalizados usados para variar o cache. |
PartialCachingAttribute(Int32, String, String, String, Boolean) |
Inicializa uma nova instância da classe PartialCachingAttribute, especificando a duração do cache, quaisquer valores |
PartialCachingAttribute(Int32, String, String, String, String, Boolean) |
Inicializa uma nova instância da classe PartialCachingAttribute, especificando a duração de cache, os valores |
PartialCachingAttribute(Int32)
Inicializa uma nova instância da classe PartialCachingAttribute com a duração especificada atribuída ao controle de usuário a ser armazenado em cache.
public:
PartialCachingAttribute(int duration);
public PartialCachingAttribute (int duration);
new System.Web.UI.PartialCachingAttribute : int -> System.Web.UI.PartialCachingAttribute
Public Sub New (duration As Integer)
Parâmetros
- duration
- Int32
A quantidade de tempo, em segundos, que um controle de usuário deve permanecer no cache de saída.
Exemplos
O exemplo de código a seguir demonstra como o PartialCachingAttribute(Int32) construtor pode ser aplicado a um controle de usuário. No exemplo, o construtor é usado para indicar que o controle de usuário pode ser armazenado em cache e para especificar a duração do cache. Este exemplo de código faz parte de um exemplo maior fornecido para a PartialCachingAttribute classe .
// 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
Aplica-se a
PartialCachingAttribute(Int32, String, String, String)
Inicializa uma nova instância da classe PartialCachingAttribute, que especifica a duração do cache, qualquer valor GET e POST, nomes de controle e requisitos de cache de saída personalizados usados para variar o cache.
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)
Parâmetros
- duration
- Int32
A quantidade de tempo, em segundos, em que o controle de usuário é armazenado em cache.
- varyByParams
- String
Uma lista separada por ponto-e-vírgula de cadeias de caracteres usadas para variar o cache de saída. Por padrão, essas cadeias de caracteres correspondem a um valor de cadeia de consulta enviado com os atributos de método GET ou para um parâmetro enviado usando o método POST. Quando esse atributo é definido com vários parâmetros, o cache de saída contém uma versão diferente do documento solicitado para cada parâmetro especificado. Os valores possíveis incluem "none", "*" e qualquer cadeia de consulta válida ou o nome do parâmetro de POST.
- varyByControls
- String
Uma lista separada por ponto-e-vírgula de cadeias de caracteres usadas para variar o cache de saída. Essas cadeias de caracteres representam nomes totalmente qualificados de propriedades em um controle de usuário. Quando esse parâmetro é usado para um controle de usuário, a saída do controle de usuário é variada no cache para cada propriedade de controle de usuário especificada.
- varyByCustom
- String
Qualquer texto que representa os requisitos de cache de saída personalizados. Se esse parâmetro receber um valor “navegador”, o cache será variado pelo nome do navegador e as informações sobre a versão principal. Se uma cadeia de caracteres personalizada for inserida, você deverá substituir o método GetVaryByCustomString(HttpContext, String) no arquivo Global.asax do aplicativo.
Exemplos
O exemplo de código a seguir demonstra como o PartialCachingAttribute(Int32, String, String, String) construtor pode ser aplicado a um controle de usuário. No exemplo, o construtor é usado para indicar que o controle de usuário pode ser armazenado em cache, especificar a duração do cache como 20 segundos e especificar um controle chamado state
para o qual a saída do controle de usuário será variada.
// 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
Aplica-se a
PartialCachingAttribute(Int32, String, String, String, Boolean)
Inicializa uma nova instância da classe PartialCachingAttribute, especificando a duração do cache, quaisquer valores GET
e POST
, nomes de controle, requisitos de cache de saída personalizados usados para variar o cache e se a saída de controle do usuário pode ser compartilhada com várias páginas.
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)
Parâmetros
- duration
- Int32
A quantidade de tempo, em segundos, em que o controle de usuário é armazenado em cache.
- varyByParams
- String
Uma lista separada por ponto-e-vírgula de cadeias de caracteres usadas para variar o cache de saída. Por padrão, essas cadeias de caracteres correspondem a um valor de cadeia de consulta enviado com os atributos do método GET
ou um parâmetro enviado usando o método POST
. Quando esse atributo é definido com vários parâmetros, o cache de saída contém uma versão diferente do documento solicitado para cada parâmetro especificado. Os valores possíveis incluem “nenhum”, “*” e qualquer cadeia de consulta ou nome de parâmetro POST
válido.
- varyByControls
- String
Uma lista separada por ponto-e-vírgula de cadeias de caracteres usadas para variar o cache de saída. Essas cadeias de caracteres representam nomes totalmente qualificados de propriedades em um controle de usuário. Quando esse parâmetro é usado para um controle de usuário, a saída do controle de usuário é variada no cache para cada propriedade de controle de usuário especificada.
- varyByCustom
- String
Qualquer texto que representa os requisitos de cache de saída personalizados. Se esse parâmetro receber um valor “navegador”, o cache será variado pelo nome do navegador e as informações sobre a versão principal. Se uma cadeia de caracteres personalizada for inserida, você deverá substituir o método GetVaryByCustomString(HttpContext, String) no arquivo Global.asax do aplicativo.
- shared
- Boolean
true
para indicar que a saída do controle de usuário pode ser compartilhada com várias páginas; caso contrário, false
.
Aplica-se a
PartialCachingAttribute(Int32, String, String, String, String, Boolean)
Inicializa uma nova instância da classe PartialCachingAttribute, especificando a duração de cache, os valores GET
e POST
, os nomes de controle, os requisitos de cache de saída personalizados usados para variar o cache, as dependências de banco de dados e se a saída do controle de usuário pode ser compartilhada com várias páginas.
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)
Parâmetros
- duration
- Int32
A quantidade de tempo, em segundos, em que o controle de usuário é armazenado em cache.
- varyByParams
- String
Uma lista separada por ponto-e-vírgula de cadeias de caracteres usadas para variar o cache de saída. Por padrão, essas cadeias de caracteres correspondem a um valor de cadeia de consulta enviado com os atributos do método GET
ou um parâmetro enviado usando o método POST
. Quando esse atributo é definido com vários parâmetros, o cache de saída contém uma versão diferente do documento solicitado para cada parâmetro especificado. Os valores possíveis incluem “nenhum”, “*” e qualquer cadeia de consulta ou nome de parâmetro POST
válido.
- varyByControls
- String
Uma lista separada por ponto-e-vírgula de cadeias de caracteres usadas para variar o cache de saída. Essas cadeias de caracteres representam nomes totalmente qualificados de propriedades em um controle de usuário. Quando esse parâmetro é usado para um controle de usuário, a saída do controle de usuário é variada no cache para cada propriedade de controle de usuário especificada.
- varyByCustom
- String
Qualquer texto que representa os requisitos de cache de saída personalizados. Se esse parâmetro receber um valor “navegador”, o cache será variado pelo nome do navegador e as informações sobre a versão principal. Se uma cadeia de caracteres personalizada for inserida, você deverá substituir o método GetVaryByCustomString(HttpContext, String) no arquivo Global.asax do aplicativo.
- sqlDependency
- String
Uma lista delimitada de nomes de banco de dados e nomes de tabela que, quando alteradas, expiram explicitamente uma entrada de cache no cache do ASP.NET. Esses nomes de banco de dados correspondem às dependências de cache do SQL Server identificadas na seção de configuração da Web.
- shared
- Boolean
true
para indicar que a saída do controle de usuário pode ser compartilhada com várias páginas; caso contrário, false
.