ControlCachePolicy.SetExpires(DateTime) Metoda

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Dá pokyn ovládacímu BasePartialCachingControl prvku, který zabalí uživatelský ovládací prvek, aby vypršela platnost položky mezipaměti v zadaném datu a čase.

public:
 void SetExpires(DateTime expirationTime);

public void SetExpires (DateTime expirationTime);

member this.SetExpires : DateTime -> unit

Public Sub SetExpires (expirationTime As DateTime)

Parametry

expirationTime: DateTime

A DateTime , po které vyprší platnost položky uložené v mezipaměti.

Výjimky

HttpException

Uživatelský ovládací prvek není přidružený k ovládacímu prvku a nelze ho BasePartialCachingControl uložit do mezipaměti.

Příklady

Následující příklad kódu ukazuje, jak lze uživatelský ovládací prvek dynamicky načítat a manipulovat programově za běhu. Atribut PartialCachingAttribute se použije u uživatelského ovládacího prvku s názvem SimpleControl, což znamená, že ovládací prvek je zabalen ovládací prvek PartialCachingControl za běhu. SimpleControl Nastavení ukládání do mezipaměti objektu lze programově manipulovat prostřednictvím přidruženého ControlCachePolicy objektu, který je k dispozici prostřednictvím odkazu na PartialCachingControl ovládací prvek, který ho zabalí. V tomto příkladu Duration je vlastnost zkoumána během inicializace stránky a změněna pomocí SetSlidingExpiration metod a SetExpires pokud jsou splněny některé podmínky. Tento příklad je součástí většího příkladu poskytnutého ControlCachePolicy pro třídu.

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

Poznámky

Pomocí metod SetExpires a SetSlidingExpiration metod (předání true) můžete dát ovládacímu BasePartialCachingControl prvku pokyn, aby ovládací prvek, který zabalí uživatelský ovládací prvek, aby místo absolutní zásady vypršení platnosti používal zásady ukládání do mezipaměti pro posuvné vypršení platnosti. Použijte metodu SetExpires a metodu SetSlidingExpiration (předání false) k určení absolutní zásady vypršení platnosti.

Platí pro

Sdílet prostřednictvím