ControlCachePolicy.SetSlidingExpiration(Boolean) Methode

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Weist das BasePartialCachingControl-Steuerelement an, das das Benutzersteuerelement umschließt, für den Cacheeintrag des Benutzersteuerelements gleitende oder absolute Ablaufzeit festzulegen.

public:
 void SetSlidingExpiration(bool useSlidingExpiration);

public void SetSlidingExpiration (bool useSlidingExpiration);

member this.SetSlidingExpiration : bool -> unit

Public Sub SetSlidingExpiration (useSlidingExpiration As Boolean)

Parameter

useSlidingExpiration: Boolean

true, um anstelle absoluter Ablaufzeit gleitende Cacheablaufzeit zu verwenden, andernfalls false.

Ausnahmen

HttpException

Das Benutzersteuerelement ist keinem BasePartialCachingControl zugeordnet und kann nicht zwischengespeichert werden.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Benutzersteuerelement zur Laufzeit dynamisch geladen und programmgesteuert bearbeitet werden kann. Ein Benutzersteuerelement mit dem Namen SimpleControl ist mit einem PartialCachingAttribute Attribut versehen, was bedeutet, dass es zur Laufzeit von einem PartialCachingControl Steuerelement umschlossen wird. Die SimpleControl Zwischenspeicherungseinstellungen des Objekts können programmgesteuert über das zugehörige ControlCachePolicy Objekt bearbeitet werden, das über einen Verweis auf das Steuerelement verfügbar ist, das PartialCachingControl es umschließt. In diesem Beispiel werden die Zwischenspeicherungseinstellungen während der Seiteninitialisierung überprüft und geändert, wenn einige Bedingungen erfüllt sind. Dieses Beispiel ist Teil eines größeren Beispiels, das für die ControlCachePolicy -Klasse bereitgestellt wird.

<%@ 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>

Hinweise

Verwenden Sie die SetExpires Methoden und SetSlidingExpiration (übergeben), trueum das BasePartialCachingControl Steuerelement anzuweisen, das das Benutzersteuerelement umschließt, eine gleitende Ablaufcacherichtlinie anstelle einer absoluten Ablaufrichtlinie zu verwenden. Verwenden Sie die SetExpires -Methode und die SetSlidingExpiration -Methode (übergeben), falseum eine absolute Ablaufrichtlinie anzugeben.

Gilt für:

Freigeben über