PartialCachingAttribute Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 |
| PartialCachingAttribute(Int32, String, String, String, String, Boolean) |
Inizializza una nuova istanza della classe PartialCachingAttribute specificando la durata di inserimento nella cache, eventuali valori |
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.PartialCachingAttributePublic 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
Si applica a
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.PartialCachingAttributePublic 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
Si applica a
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.PartialCachingAttributePublic 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.
Si applica a
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.PartialCachingAttributePublic 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.