PartialCachingAttribute Costruttori

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

Inizializza una nuova istanza della classe PartialCachingAttribute.

Overload

PartialCachingAttribute(Int32)	Inizializza una nuova istanza della classe PartialCachingAttribute con la durata assegnata al controllo utente da memorizzare nella cache.
PartialCachingAttribute(Int32, String, String, String)	Inizializza una nuova istanza della classe PartialCachingAttribute specificando la durata di memorizzazione nella cache, eventuali valori GET e POST, nomi di controlli e requisiti personalizzati della cache di output utilizzati per variare la cache.
PartialCachingAttribute(Int32, String, String, String, Boolean)	Inizializza una nuova istanza della classe PartialCachingAttribute specificando la durata di inserimento nella cache, eventuali valori GET e POST, nomi di controlli, requisiti personalizzati di cache di output utilizzati per variare la cache e se l'output del controllo utente può essere condiviso con più pagine.
PartialCachingAttribute(Int32, String, String, String, String, Boolean)	Inizializza una nuova istanza della classe PartialCachingAttribute specificando la durata di inserimento nella cache, eventuali valori GET e POST, nomi di controlli, requisiti personalizzati di cache di output utilizzati per variare la cache, le dipendenze di database e se l'output del controllo utente può essere condiviso con più pagine.

PartialCachingAttribute(Int32)

Inizializza una nuova istanza della classe PartialCachingAttribute con la durata assegnata al controllo utente da memorizzare nella 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)

Parametri

duration

Int32

Intervallo di tempo, in secondi, di permanenza di un controllo utente nella cache di output.

Esempio

Nell'esempio di codice seguente viene illustrato come applicare il PartialCachingAttribute(Int32) costruttore a un controllo utente. Nell'esempio, il costruttore viene usato per indicare che il controllo utente può essere memorizzato nella cache e per specificare la durata della memorizzazione nella cache. Questo esempio di codice fa parte di un esempio più ampio fornito per la 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

PartialCachingAttribute(Int32, String, String, String)

Inizializza una nuova istanza della classe PartialCachingAttribute specificando la durata di memorizzazione nella cache, eventuali valori GET e POST, nomi di controlli e requisiti personalizzati della cache di output utilizzati per variare la 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)

Parametri

duration

Int32

Quantità di tempo in secondi durante la quale il controllo utente rimane nella cache.

varyByParams

String

Un elenco di stringhe separate da punto e virgola utilizzate per variare la cache di output. Per impostazione predefinita, queste stringhe corrispondono al valore stringa di query inviato con gli attributi del metodo GET oppure a un parametro inviato utilizzando il metodo POST. Quando questo attributo è impostato su più parametri, la cache di output contiene una versione diversa del documento richiesto per ciascun parametro specificato. I possibili valori includono "none", "*" e qualsiasi nome di parametro di stringa di query o POST valido.

varyByControls

String

Un elenco di stringhe separate da punto e virgola utilizzate per variare la cache di output. Queste stringhe rappresentano nomi completi di proprietà su un controllo utente. Quando questo parametro è utilizzato per un controllo utente, l'output del controllo utente varia nella cache per ogni proprietà del controllo utente specificata.

varyByCustom

String

Testo che rappresenta requisiti personalizzati di memorizzazione dell'output nella cache. Se a questo parametro viene assegnato un valore di "browser", la cache varia a seconda del nome del browser e del numero di versione principale. Se viene inserita una stringa personalizzata, è necessario eseguire l'override del metodo GetVaryByCustomString(HttpContext, String) nel file Global.asax dell'applicazione.

Esempio

Nell'esempio di codice seguente viene illustrato come applicare il PartialCachingAttribute(Int32, String, String, String) costruttore a un controllo utente. Nell'esempio, il costruttore viene usato per indicare che il controllo utente può essere memorizzato nella cache, specificare la durata della memorizzazione nella cache come 20 secondi e specificare un controllo denominato state per il quale l'output del controllo utente sarà diverso.

// 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)

Inizializza una nuova istanza della classe PartialCachingAttribute specificando la durata di inserimento nella cache, eventuali valori GET e POST, nomi di controlli, requisiti personalizzati di cache di output utilizzati per variare la cache e se l'output del controllo utente può essere condiviso con più pagine.

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)

Parametri

duration

Int32

Quantità di tempo in secondi durante la quale il controllo utente rimane nella cache.

varyByParams

String

Un elenco di stringhe separate da punto e virgola utilizzate per variare la cache di output. In base all'impostazione predefinita, queste stringhe corrispondono al valore stringa di query inviato con attributi di metodo GET oppure a un parametro inviato utilizzando il metodo POST. Quando questo attributo è impostato su più parametri, la cache di output contiene una versione diversa del documento richiesto per ciascun parametro specificato. I possibili valori includono "none", "*" e qualsiasi nome di parametro POST o stringa di query valida.

varyByControls

String

Un elenco di stringhe separate da punto e virgola utilizzate per variare la cache di output. Queste stringhe rappresentano nomi completi di proprietà su un controllo utente. Quando questo parametro è utilizzato per un controllo utente, l'output del controllo utente varia nella cache per ogni proprietà del controllo utente specificata.

varyByCustom

String

Testo che rappresenta requisiti personalizzati di memorizzazione dell'output nella cache. Se a questo parametro viene assegnato un valore di "browser", la cache varia a seconda del nome del browser e del numero di versione principale. Se viene inserita una stringa personalizzata, è necessario eseguire l'override del metodo GetVaryByCustomString(HttpContext, String) nel file Global.asax dell'applicazione.

shared

Boolean

true per indicare che l'output del controllo utente può essere condiviso con più pagine; in caso contrario, false.

PartialCachingAttribute(Int32, String, String, String, String, Boolean)

Inizializza una nuova istanza della classe PartialCachingAttribute specificando la durata di inserimento nella cache, eventuali valori GET e POST, nomi di controlli, requisiti personalizzati di cache di output utilizzati per variare la cache, le dipendenze di database e se l'output del controllo utente può essere condiviso con più pagine.

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)

Parametri

duration

Int32

Quantità di tempo in secondi durante la quale il controllo utente rimane nella cache.

varyByParams

String

Un elenco di stringhe separate da punto e virgola utilizzate per variare la cache di output. In base all'impostazione predefinita, queste stringhe corrispondono al valore stringa di query inviato con attributi di metodo GET oppure a un parametro inviato utilizzando il metodo POST. Quando questo attributo è impostato su più parametri, la cache di output contiene una versione diversa del documento richiesto per ciascun parametro specificato. I possibili valori includono "none", "*" e qualsiasi nome di parametro POST o stringa di query valida.

varyByControls

String

Un elenco di stringhe separate da punto e virgola utilizzate per variare la cache di output. Queste stringhe rappresentano nomi completi di proprietà su un controllo utente. Quando questo parametro è utilizzato per un controllo utente, l'output del controllo utente varia nella cache per ogni proprietà del controllo utente specificata.

varyByCustom

String

Testo che rappresenta requisiti personalizzati di memorizzazione dell'output nella cache. Se a questo parametro viene assegnato un valore di "browser", la cache varia a seconda del nome del browser e del numero di versione principale. Se viene inserita una stringa personalizzata, è necessario eseguire l'override del metodo GetVaryByCustomString(HttpContext, String) nel file Global.asax dell'applicazione.

sqlDependency

String

Elenco delimitato di nomi di database e di nomi di tabelle che, se modificati, causano la scadenza di una voce di cache nella cache ASP.NET. Questi nomi di database corrispondono alle dipendenze della cache di SQL Server identificate nella sezione di configurazione Web.

shared

Boolean

true per indicare che l'output del controllo utente può essere condiviso con più pagine; in caso contrario, false.