Condividi tramite

ControlCachePolicy.SetExpires(DateTime) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

Indica al controllo BasePartialCachingControl che esegue il wrapping del controllo utente di far scadere la voce della cache alla data e all'ora specificate.

public:
 void SetExpires(DateTime expirationTime);
public void SetExpires (DateTime expirationTime);
member this.SetExpires : DateTime -> unit
Public Sub SetExpires (expirationTime As DateTime)

Parametri

expirationTime
DateTime

Oggetto DateTime dopo il quale la voce nella cache scade.

Eccezioni

HttpException

Il controllo utente non è associato a un oggetto BasePartialCachingControl e non può essere inserito nella cache.

Esempio

Nell'esempio di codice seguente viene illustrato il modo in cui un controllo utente può essere caricato dinamicamente e modificato a livello di codice in fase di esecuzione. L'attributo PartialCachingAttribute viene applicato a un controllo utente denominato SimpleControl, il che significa che il controllo utente viene sottoposto a wrapping da un PartialCachingControl controllo in fase di esecuzione. Le SimpleControl impostazioni di memorizzazione nella cache dell'oggetto possono essere modificate a livello di codice tramite l'oggetto associato ControlCachePolicy , disponibili tramite un riferimento al controllo che lo esegue il PartialCachingControl wrapping. In questo esempio la proprietà viene esaminata durante l'inizializzazione Duration della pagina e modificata usando i SetSlidingExpiration metodi e SetExpires se vengono soddisfatte alcune condizioni. Questo esempio fa parte di un esempio più grande fornito per 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>

Commenti

Usare i SetExpires metodi e SetSlidingExpiration (passando true) per indicare al controllo che esegue il wrapping del controllo utente per usare un criterio di memorizzazione nella BasePartialCachingControl cache di scadenza scorrevole anziché un criterio di scadenza assoluto. Usare il metodo e il SetExpires SetSlidingExpiration metodo (passando false) per specificare un criterio di scadenza assoluto.

Si applica a

Vedi anche