PartialCachingAttribute Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Initialise une nouvelle instance de la classe PartialCachingAttribute.
Surcharges
| PartialCachingAttribute(Int32) |
Initialise une nouvelle instance de la classe PartialCachingAttribute avec la durée spécifiée assignée au contrôle utilisateur à mettre en cache. |
| PartialCachingAttribute(Int32, String, String, String) |
Initialise une nouvelle instance de la classe PartialCachingAttribute en spécifiant la durée de mise en cache, les valeurs GET et POST, les noms de contrôles, ainsi que les exigences de mise en cache de sortie personnalisée nécessaires à la variation du cache. |
| PartialCachingAttribute(Int32, String, String, String, Boolean) |
Initialise une nouvelle instance de la classe PartialCachingAttribute, en spécifiant la durée de mise en cache, toutes les valeurs |
| PartialCachingAttribute(Int32, String, String, String, String, Boolean) |
Initialise une nouvelle instance de la classe PartialCachingAttribute, en spécifiant la durée de mise en cache, toutes les valeurs |
PartialCachingAttribute(Int32)
Initialise une nouvelle instance de la classe PartialCachingAttribute avec la durée spécifiée assignée au contrôle utilisateur à mettre en cache.
public:
PartialCachingAttribute(int duration);public PartialCachingAttribute (int duration);new System.Web.UI.PartialCachingAttribute : int -> System.Web.UI.PartialCachingAttributePublic Sub New (duration As Integer)Paramètres
- duration
- Int32
Durée, en secondes, pendant laquelle un contrôle utilisateur doit rester dans le cache de sortie.
Exemples
L’exemple de code suivant montre comment le PartialCachingAttribute(Int32) constructeur peut être appliqué à un contrôle utilisateur. Dans l’exemple, le constructeur est utilisé pour indiquer que le contrôle utilisateur peut être mis en cache et pour spécifier la durée de mise en cache. Cet exemple de code fait partie d’un exemple plus grand fourni pour 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
S’applique à
PartialCachingAttribute(Int32, String, String, String)
Initialise une nouvelle instance de la classe PartialCachingAttribute en spécifiant la durée de mise en cache, les valeurs GET et POST, les noms de contrôles, ainsi que les exigences de mise en cache de sortie personnalisée nécessaires à la variation du 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)Paramètres
- duration
- Int32
Durée, en secondes, de la mise en cache du contrôle utilisateur.
- varyByParams
- String
Liste des chaînes utilisées pour faire varier le cache de sortie, séparées par des points-virgules. Par défaut, ces chaînes correspondent à une valeur de chaîne de requête envoyée avec les attributs de la méthode GET, ou à un paramètre envoyé à l'aide de la méthode POST. Lorsque cet attribut correspond à plusieurs paramètres, le cache de sortie contient une version différente du document demandé pour chaque paramètre spécifié. Les valeurs possibles sont notamment "none", "*" et toute autre chaîne de requête ou nom de paramètre POST valide.
- varyByControls
- String
Liste des chaînes utilisées pour faire varier le cache de sortie, séparées par des points-virgules. Ces chaînes représentent des noms qualifiés complets de propriété sur un contrôle utilisateur. Lorsque ce paramètre est employé pour un contrôle utilisateur, la sortie du contrôle utilisateur varie dans le cache pour chaque propriété du contrôle utilisateur spécifiée.
- varyByCustom
- String
Tout texte qui représente des paramètres personnalisés de mise en cache de sortie. Si ce paramètre reçoit la valeur "browser", le cache varie selon le nom du navigateur et les informations de version principales. Si une chaîne personnalisée est entrée, vous devez substituer la méthode GetVaryByCustomString(HttpContext, String) dans le fichier Global.asax de votre application.
Exemples
L’exemple de code suivant montre comment le PartialCachingAttribute(Int32, String, String, String) constructeur peut être appliqué à un contrôle utilisateur. Dans l’exemple, le constructeur est utilisé pour indiquer que le contrôle utilisateur peut être mis en cache, spécifier la durée de mise en cache de 20 secondes et spécifier un contrôle nommé state pour lequel la sortie du contrôle utilisateur sera variée.
// 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
S’applique à
PartialCachingAttribute(Int32, String, String, String, Boolean)
Initialise une nouvelle instance de la classe PartialCachingAttribute, en spécifiant la durée de mise en cache, toutes les valeurs GET et POST, les noms de contrôles, les configurations requises de mise en cache de sortie personnalisées utilisées pour varier le cache et en indiquant si la sortie de contrôle utilisateur peut être partagée avec plusieurs pages.
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)Paramètres
- duration
- Int32
Durée, en secondes, de la mise en cache du contrôle utilisateur.
- varyByParams
- String
Liste des chaînes utilisées pour faire varier le cache de sortie, séparées par des points-virgules. Par défaut, ces chaînes correspondent à une valeur de chaîne de requête envoyée avec les attributs de la méthode GET ou à un paramètre envoyé avec la méthode POST. Lorsque cet attribut correspond à plusieurs paramètres, le cache de sortie contient une version différente du document demandé pour chaque paramètre spécifié. Les valeurs possibles sont notamment "none", "*" et toute autre chaîne de requête ou nom de paramètre POST valide.
- varyByControls
- String
Liste des chaînes utilisées pour faire varier le cache de sortie, séparées par des points-virgules. Ces chaînes représentent des noms qualifiés complets de propriété sur un contrôle utilisateur. Lorsque ce paramètre est employé pour un contrôle utilisateur, la sortie du contrôle utilisateur varie dans le cache pour chaque propriété du contrôle utilisateur spécifiée.
- varyByCustom
- String
Tout texte qui représente des paramètres personnalisés de mise en cache de sortie. Si ce paramètre reçoit la valeur "browser", le cache varie selon le nom du navigateur et les informations de version principales. Si une chaîne personnalisée est entrée, vous devez substituer la méthode GetVaryByCustomString(HttpContext, String) dans le fichier Global.asax de votre application.
- shared
- Boolean
true pour indiquer que la sortie d'un contrôle utilisateur peut être partagée par plusieurs pages ; sinon false.
S’applique à
PartialCachingAttribute(Int32, String, String, String, String, Boolean)
Initialise une nouvelle instance de la classe PartialCachingAttribute, en spécifiant la durée de mise en cache, toutes les valeurs GET et POST, les noms de contrôles, les configurations requises de mise en cache de sortie personnalisées utilisées pour varier le cache, les dépendances de la base de données et en indiquant si la sortie de contrôle utilisateur peut être partagée avec plusieurs pages.
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)Paramètres
- duration
- Int32
Durée, en secondes, de la mise en cache du contrôle utilisateur.
- varyByParams
- String
Liste des chaînes utilisées pour faire varier le cache de sortie, séparées par des points-virgules. Par défaut, ces chaînes correspondent à une valeur de chaîne de requête envoyée avec les attributs de la méthode GET ou à un paramètre envoyé avec la méthode POST. Lorsque cet attribut correspond à plusieurs paramètres, le cache de sortie contient une version différente du document demandé pour chaque paramètre spécifié. Les valeurs possibles sont notamment "none", "*" et toute autre chaîne de requête ou nom de paramètre POST valide.
- varyByControls
- String
Liste des chaînes utilisées pour faire varier le cache de sortie, séparées par des points-virgules. Ces chaînes représentent des noms qualifiés complets de propriété sur un contrôle utilisateur. Lorsque ce paramètre est employé pour un contrôle utilisateur, la sortie du contrôle utilisateur varie dans le cache pour chaque propriété du contrôle utilisateur spécifiée.
- varyByCustom
- String
Tout texte qui représente des paramètres personnalisés de mise en cache de sortie. Si ce paramètre reçoit la valeur "browser", le cache varie selon le nom du navigateur et les informations de version principales. Si une chaîne personnalisée est entrée, vous devez substituer la méthode GetVaryByCustomString(HttpContext, String) dans le fichier Global.asax de votre application.
- sqlDependency
- String
La modification d'une liste délimitée de noms de bases de données et de tables fait expirer explicitement une entrée du cache d'ASP.NET. Ces noms de bases de données correspondent à ces dépendances de cache SQL Server identifiées dans votre section de configuration Web.
- shared
- Boolean
true pour indiquer que la sortie d'un contrôle utilisateur peut être partagée par plusieurs pages ; sinon false.