Partilhar via


PartialCachingAttribute Construtores

Definição

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 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.

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.

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.

Aplica-se a