ControlCachePolicy.SetSlidingExpiration(Boolean) Méthode

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

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.

Commande au contrôle BasePartialCachingControl qui encapsule le contrôle utilisateur d'indiquer à l'entrée de cache du contrôle utilisateur d'utiliser l'expiration décalée ou absolue.

public:
 void SetSlidingExpiration(bool useSlidingExpiration);

public void SetSlidingExpiration (bool useSlidingExpiration);

member this.SetSlidingExpiration : bool -> unit

Public Sub SetSlidingExpiration (useSlidingExpiration As Boolean)

Paramètres

useSlidingExpiration: Boolean

true pour utiliser l'expiration de cache décalée au lieu de l'expiration absolue ; sinon, false.

Exceptions

HttpException

Le contrôle utilisateur n'est pas associé à un BasePartialCachingControl et ne peut pas être mis en cache.

Exemples

L’exemple de code suivant montre comment un contrôle utilisateur peut être chargé dynamiquement et manipulé par programmation au moment de l’exécution. Un contrôle utilisateur nommé SimpleControl est décoré avec un PartialCachingAttribute attribut, ce qui signifie qu’il est encapsulé par un PartialCachingControl contrôle au moment de l’exécution. Les SimpleControl paramètres de mise en cache de l’objet peuvent être manipulés par programmation via son objet associé ControlCachePolicy , qui est disponible via une référence au contrôle qui l’encapsule PartialCachingControl . Dans cet exemple, les paramètres de mise en cache sont examinés lors de l’initialisation de la page et modifiés si certaines conditions sont remplies. Cet exemple fait partie d’un exemple plus grand fourni pour la ControlCachePolicy classe .

<%@ Page Language="C#" %>
<%@ Reference Control="SimpleControl.ascx" %>
<script language="C#" runat="server">

// The following example demonstrates how to load a user control dynamically at run time, and
// work with the ControlCachePolicy object associated with it.

// Loads and displays a UserControl defined in a seperate Logonform.ascx file.
// You need to have "SimpleControl.ascx" file in 
// the same directory as the aspx file. 

void Page_Init(object sender, System.EventArgs e) {
    
    // Obtain a PartialCachingControl object which wraps the 'LogOnControl' user control.
    PartialCachingControl pcc = LoadControl("SimpleControl.ascx") as PartialCachingControl;        
    
    // If the control is slated to expire in greater than 60 Seconds
    if (pcc.CachePolicy.Duration > TimeSpan.FromSeconds(60) ) 
    {        
        // Make it expire faster. Set a new expiration time to 30 seconds, and make it
        // an absolute expiration if it isnt already.        
        pcc.CachePolicy.SetExpires(DateTime.Now.Add(TimeSpan.FromSeconds(30)));
        pcc.CachePolicy.SetSlidingExpiration(false);
    }                    
    Controls.Add(pcc);
}
</script>

<%@ Page Language="VB" %>
<%@ Reference Control="SimpleControl.ascx" %>
<script language="VB" runat="server">

    ' The following example demonstrates how to load a user control dynamically at run time, and
    ' work with the ControlCachePolicy object associated with it.

    ' Loads and displays a UserControl defined in a seperate Logonform.ascx file.
    ' You need to have "SimpleControl.ascx" file in 
    ' the same directory as the aspx file. 

    Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs)
    
        ' Obtain a PartialCachingControl object which wraps the 'LogOnControl' user control.
        Dim pcc As PartialCachingControl
        pcc = LoadControl("SimpleControl.ascx")
    
        ' If the control is slated to expire in greater than 60 Seconds
        If (pcc.CachePolicy.Duration > TimeSpan.FromSeconds(60)) Then
            ' Make it expire faster. Set a new expiration time to 30 seconds, and make it
            ' an absolute expiration if it isnt already.        
            pcc.CachePolicy.SetExpires(DateTime.Now.Add(TimeSpan.FromSeconds(30)))
            pcc.CachePolicy.SetSlidingExpiration(False)
        End If
        Controls.Add(pcc)
    End Sub
</script>

Remarques

Utilisez les SetExpires méthodes et SetSlidingExpiration (passant true) pour indiquer au BasePartialCachingControl contrôle qui encapsule le contrôle utilisateur d’utiliser une stratégie de mise en cache d’expiration glissante au lieu d’une stratégie d’expiration absolue. Utilisez la SetExpires méthode et la SetSlidingExpiration méthode (passant false) pour spécifier une stratégie d’expiration absolue.

S’applique à