HttpResponse.AddCacheItemDependency(String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
キャッシュ内の他のアイテムに依存するキャッシュされた応答を有効にします。
public:
void AddCacheItemDependency(System::String ^ cacheKey);public void AddCacheItemDependency (string cacheKey);member this.AddCacheItemDependency : string -> unitPublic Sub AddCacheItemDependency (cacheKey As String)パラメーター
- cacheKey
- String
キャッシュされた応答が依存するアイテムのキー。
例
次の例は、キャッシュされた出力 ASP.NET ユーザー コントロールです。 コントロールのコードは、パラメーターとして渡されたオブジェクトに格納されている項目のキーを使用してCacheメソッドを呼び出AddCacheItemDependencyします。 項目がキャッシュに存在しない場合、出力キャッシュに格納されたコントロールの応答は無効になります。 つまり、後続の要求では、コントロールの応答の新しいバージョンが出力キャッシュに追加されます。
次に、キーに関連付 bookData けられている項目がオブジェクトに Cache 格納されているかどうかをチェックし、結果に依存する 2 行のテキストのいずれかを表示します。 次に、コードは、カスタム DataHelper クラスの共有GetBookDataメソッドのDataGrid呼び出しで名前が付けられたdgBooksコントロールのプロパティを設定DataSourceし、メソッドをDataGridDataBind設定します。
<%@ Control Language="c#" %>
<%@ Outputcache duration="10" varybyparam="none" shared="True" %>
<%@ Import Namespace = "Samples.AspNet.CS" %>
<%@ Import Namespace = "System.Data" %>
<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
// Make user control invalid if the
// cache item changes or expires.
Response.AddCacheItemDependency("bookData");
// Create a DataView object.
DataView source = (DataView)Cache["bookData"];
// Check if the view is stored in the cache
// and generate the right label text
// dependent upon what is returned.
if (source == null)
{
source = DataHelper.GetBookData();
lblCacheMsg.Text = "Data generated explicitly.";
}
else
{
lblCacheMsg.Text = "Data retrieved from application cache.";
}
dgBooks.DataSource = source;
dgBooks.DataBind();
lblOutputMessage.Text = DateTime.Now.ToString();
}
</script>
<table>
<tbody>
<tr>
<th>
Books</th>
<td>
</td>
</tr>
<tr>
<td>
<asp:DataGrid id="dgBooks" runat="server"></asp:DataGrid>
</td>
<td>
</td>
</tr>
<tr>
<td>
<asp:Label id="lblCacheMsg" runat="server"></asp:Label>
</td>
<td>
</td>
</tr>
<tr>
<td>
The control was created at:
</td>
<td>
<asp:Label id="lblOutputMessage" runat="server"></asp:Label>
</td>
</tr>
</tbody>
</table>
<%@ Control Language="vb" %>
<%@ Outputcache duration="10" varybyparam="none" shared="True" %>
<%@ Import Namespace="Samples.AspNet.VB" %>
<%@ Import Namespace="System.Data" %>
<script runat="server">
Private Sub Page_Load(sender As Object, e As System.EventArgs)
' Make user control invalid if the
' cache item changes or expires.
Response.AddCacheItemDependency("bookData")
' Create a DataView object.
Dim source As DataView = Cache("bookData")
' Check if the view is stored in the cache
' and generate the right label text
' dependent upon what is returned.
If source Is Nothing Then
source = DataHelper.GetBookData()
lblCacheMsg.Text = "Data generated explicitly."
Else
lblCacheMsg.Text = "Data retrieved from application cache."
End If
dgBooks.DataSource = source
dgBooks.DataBind()
lblOutputMessage.Text = DateTime.Now.ToString()
End Sub
</script>
<table>
<tbody>
<tr>
<th>
Books</th>
<td>
</td>
</tr>
<tr>
<td>
<asp:DataGrid id="dgBooks" runat="server"></asp:DataGrid>
</td>
<td>
</td>
</tr>
<tr>
<td>
<asp:Label id="lblCacheMsg" runat="server"></asp:Label>
</td>
<td>
</td>
</tr>
<tr>
<td>
The control was created at:
</td>
<td>
<asp:Label id="lblOutputMessage" runat="server"></asp:Label>
</td>
</tr>
</tbody>
</table>
注釈
パラメーターに対応する項目が cacheKey キャッシュから削除されると、現在のアイテムのキャッシュされた応答は無効です。