ControlCachePolicy.SetExpires(DateTime) Метод

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Указывает BasePartialCachingControl элементу управления, который упаковывает пользовательский элемент управления, чтобы срок действия записи кэша истекал по заданной дате и времени.

public:
 void SetExpires(DateTime expirationTime);

public void SetExpires(DateTime expirationTime);

member this.SetExpires : DateTime -> unit

Public Sub SetExpires (expirationTime As DateTime)

Параметры

expirationTime

DateTime

Значение, DateTime после которого истекает срок действия кэшированного элемента.

Исключения

HttpException

Пользовательский элемент управления не связан с элементом управления и BasePartialCachingControl не является кэшируемым.

Примеры

В следующем примере кода показано, как пользовательский элемент управления можно загружать динамически и управлять ими программным способом во время выполнения. Атрибут PartialCachingAttribute применяется к имени SimpleControlпользовательского элемента управления, что означает, что пользовательский элемент управления упаковывается элементом PartialCachingControl управления во время выполнения. SimpleControl Параметры кэширования объекта можно программным способом управлять с помощью связанного ControlCachePolicy объекта, который доступен через ссылку на PartialCachingControl элемент управления, который обтекает его. В этом примере Duration свойство проверяется во время инициализации страниц и изменяется с помощью SetSlidingExpiration методов и SetExpires методов, если выполняются некоторые условия. Этот пример является частью более крупного примера, предоставленного ControlCachePolicy для класса.

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

Комментарии

SetExpires Используйте методы и SetSlidingExpiration методы, trueчтобы указать BasePartialCachingControl элементу управления, который упаковывает пользовательский элемент управления для использования политики кэширования с скользящим сроком действия вместо абсолютной политики истечения срока действия. SetExpires Используйте метод и SetSlidingExpiration метод (передачаfalse), чтобы указать абсолютную политику истечения срока действия.

См. также раздел

• Duration
• SetSlidingExpiration(Boolean)