Udostępnij za pośrednictwem

BasePartialCachingControl.CachePolicy Właściwość

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

ControlCachePolicy Pobiera obiekt skojarzony z opakowaną kontrolką użytkownika.

public:
 property System::Web::UI::ControlCachePolicy ^ CachePolicy { System::Web::UI::ControlCachePolicy ^ get(); };
public System.Web.UI.ControlCachePolicy CachePolicy { get; }
member this.CachePolicy : System.Web.UI.ControlCachePolicy
Public ReadOnly Property CachePolicy As ControlCachePolicy

Wartość właściwości

ControlCachePolicy

Element ControlCachePolicy , który przechowuje właściwości związane z buforowaniem danych wyjściowych opakowanej kontrolki użytkownika.

Przykłady

Poniższy przykład kodu pokazuje, jak kontrolka użytkownika może być ładowana dynamicznie i manipulowana programowo w czasie wykonywania. Ten przykład zawiera trzy części:

  • Klasa częściowa , LogOnControlktóra dziedziczy z klasy bazowej UserControl i do której PartialCachingAttribute jest stosowany atrybut.

  • Kontrolka użytkownika używana z klasą częściową LogOnControl .

  • Strona formularzy sieci Web hostujących kontrolkę użytkownika.

Aby pomyślnie uruchomić ten przykład, upewnij się, że plik kontrolki użytkownika (ascx), jego plik za kodem (.cs lub .vb) oraz strona formularzy sieci Web hostujących kontrolkę użytkownika (.aspx) znajduje się w tym samym katalogu.

W pierwszej części przykładu pokazano, jak PartialCachingAttribute jest stosowany do kontrolki użytkownika o nazwie LogOnControl, co oznacza, że kontrolka użytkownika jest owinięta przez kontrolkę PartialCachingControl w czasie wykonywania. LogOnControl Ustawienia buforowania obiektu można programowo manipulować za pośrednictwem skojarzonego ControlCachePolicy obiektu, który jest dostępny za pośrednictwem odwołania do PartialCachingControl tego obiektu. W tym przykładzie ustawienia buforowania są analizowane podczas inicjowania strony i zmieniane w przypadku spełnienia pewnych warunków.

using System;
using System.Web.UI;
using System.Web.UI.WebControls;

[PartialCaching(100)]
public class LogOnControl:UserControl
{
    public TextBox user;
    public TextBox password;
}

Imports System.Web.UI
Imports System.Web.UI.WebControls

<PartialCaching(100)> _
Public Class LogOnControl
   Inherits UserControl

   Public user As TextBox
   Public password As TextBox

End Class

W drugiej części przykładu przedstawiono kontrolkę użytkownika używaną z poprzednim przykładem w celu zademonstrowania buforowania kontrolek użytkownika.

<%@ control inherits = "LogOnControl" src = "LogOnControl.cs" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<table style="font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing="15">
<tr>
<td><b>Login: </b></td>
<td><asp:TextBox id="user" runat="server"/></td>
</tr>
<tr>
<td><b>Password: </b></td>
<td><asp:TextBox id="password" TextMode="Password" runat="server"/></td>
</tr>
<tr>
</tr>
</table>
</form>
</body>
</html>

<%@ control inherits = "LogOnControl" src = "LogOnControl.vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<table style="font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing="15">
<tr>
<td><b>Login: </b></td>
<td><ASP:TextBox id="user" runat="server"/></td>
</tr>
<tr>
<td><b>Password: </b></td>
<td><ASP:TextBox id="password" TextMode="Password" runat="server"/></td>
</tr>
<tr>
</tr>
</table>
</form>
</body>
</html>

Trzecia część przykładu pokazuje użycie LogOnControl kontrolki użytkownika ze strony formularzy sieci Web.

<%@ Page Language="C#" Debug = "true"%>
<%@ Reference Control="Logonformcs.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 "Logonform.ascx" and "LogOnControl.cs" 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("Logonform.cs.ascx") as PartialCachingControl;        
    
    ControlCachePolicy cacheSettings = pcc.CachePolicy;
    
    // If the control is slated to expire in greater than 60 Seconds
    if (cacheSettings.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.        
        cacheSettings.SetExpires(DateTime.Now.Add(TimeSpan.FromSeconds(30)));
        cacheSettings.SetSlidingExpiration(false);
    }                    
    Controls.Add(pcc);
}
</script>

<%@ Page Language="VB" Debug = "true"%>
<%@ Reference Control="Logonformvb.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 "Logonform.ascx" and "LogOnControl.vb" file in 
    ' the same directory as the aspx file.
    Sub Page_Init(ByVal Sender As Object, ByVal e As EventArgs)

        ' Obtain a PartialCachingControl object which wraps the 'LogOnControl' user control.
        Dim pcc As PartialCachingControl
        pcc = CType(LoadControl("Logonform.vb.ascx"), PartialCachingControl)
    
        Dim cacheSettings As ControlCachePolicy
        cacheSettings = pcc.CachePolicy
    
        ' If the control is slated to expire in greater than 60 Seconds
        If (cacheSettings.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.        
            cacheSettings.SetExpires(DateTime.Now.Add(TimeSpan.FromSeconds(30)))
            cacheSettings.SetSlidingExpiration(False)
        End If
        Controls.Add(pcc)

    End Sub ' Page_Init
              
</script>

Uwagi

Właściwość CachePolicy umożliwia programowy dostęp do ControlCachePolicy obiektu skojarzonego z kontrolką użytkownika zawartą w wystąpieniu BasePartialCachingControl . Obiekt ControlCachePolicy można programowo manipulować, aby wpłynąć na zachowanie i ustawienia buforowania kontrolki użytkownika.

Dotyczy

Zobacz też