ControlCachePolicy.Duration プロパティ

.NET Framework クラス ライブラリ リファレンス

ControlCachePolicy.Duration プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

キャッシュされたアイテムが出力キャッシュ内に存続する時間を取得または設定します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property Duration As
 TimeSpan

Visual Basic (使用法)

Dim instance As ControlCachePolicy
Dim value As TimeSpan

value = instance.Duration

instance.Duration = value

C#

public TimeSpan Duration { get; set;
 }

C++

public:
property TimeSpan Duration {
    TimeSpan get ();
    void set (TimeSpan value);
}

J#

/** @property */
public TimeSpan get_Duration ()

/** @property */
public void set_Duration (TimeSpan value)

JScript

public function get Duration
 () : TimeSpan

public function set Duration
 (value : TimeSpan)

プロパティ値
ユーザー コントロールが出力キャッシュ内に存続する時間を表す TimeSpan。既定値は Zero です。

例外

例外の種類	条件
HttpException	ユーザー コントロールは、BasePartialCachingControl に関連付けられておらず、キャッシュに保存することはできません。 または Duration プロパティが、コントロールの初期化段階および表示段階以外で設定されています。

解説

SetSlidingExpiration メソッドを使用して絶対有効期限ポリシーが設定された場合、Duration プロパティは、キャッシュ エントリの有効期限までの残り時間を返します。

使用例

実行時にプログラムからユーザー コントロールを動的に読み込み、操作する方法を次のコード例に示します。PartialCachingAttribute 属性が SimpleControl というユーザー コントロールに適用されます。これは、ユーザー コントロールが実行時に PartialCachingControl コントロールによってラップされることを意味します。SimpleControl オブジェクトのキャッシュ設定は、関連付けられた ControlCachePolicy オブジェクト (このオブジェクトをラップする PartialCachingControl コントロールへの参照を使用してアクセス可能) を通じてプログラムから操作できます。この例では、ページの初期化中に Duration プロパティを調べ、いくつかの条件を満たした場合、キャッシュの有効期限を変更します。このコード例は、ControlCachePolicy クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ControlCachePolicy クラス
ControlCachePolicy メンバ
System.Web.UI 名前空間
SetExpires
SetSlidingExpiration