方法 : パラメータに基づいたユーザーコントロールの複数バージョンをキャッシュする

2014-10-22

更新 : 2007 年 11 月

ユーザーコントロール出力のキャッシュは次の 2 つの方法で切り替えることができます。

クエリ文字列またはフォームの POST パラメータと共にユーザーコントロール名を指定します。この操作は、@ OutputCache ディレクティブの VaryByParam 属性を使用して、宣言によって行うことができます。また、ユーザーコントロールのコード内で PartialCachingAttribute の VaryByParams プロパティを設定して、プログラミングによって行うこともできます。

ユーザーコントロールに含まれる ASP.NET サーバーコントロールの ID プロパティを指定します。この操作は、VaryByControl 属性を使用して、宣言によって行うことができます。また、PartialCachingAttribute の VaryByControls プロパティを設定して、プログラミングによって行うこともできます。

メモ :
キャッシュへのユーザーコントロール出力をクエリ文字列またはフォームの POST パラメータに基づいて切り替える方法は、ユーザーコントロール自体がポストバックし、ポストバックを処理する場合にだけ有効です。ユーザーコントロールが、ユーザーコントールを含むページにポストバックする場合は、このタイプのユーザーコントロール出力キャッシュは正しく機能しません。

キャッシュへのユーザーコントロール出力をクエリ文字列またはフォームの POST パラメータに基づいて切り替える方法は、ユーザーコントロール自体がポストバックし、ポストバックを処理する場合にだけ有効です。ユーザーコントロールが、ユーザーコントールを含むページにポストバックする場合は、このタイプのユーザーコントロール出力キャッシュは正しく機能しません。

VaryByControl 属性を使用して、ユーザーコントロールの複数のバージョンを宣言によってキャッシュするには

ポストバックするユーザーコントロールを作成します。

ユーザーコントロールに、Duration 属性と VaryByControl 属性を持つ @ OutputCache ディレクティブを含めます。

メモ :
このディレクティブで VaryByControl 属性を使用する場合は、VaryByParam 属性を含める必要はありません。ただし、この属性を含めて "None" と設定することはできます。

VaryByControl 属性に、ユーザーコントロール出力の切り替えの基準となるコントロールの ID を設定します。

たとえぱ、次の @ OutputCache ディレクティブでは、ユーザーコントロールの有効期限が 60 秒に設定され、コントロールの出力は、ID が State の ASP.NET サーバーコントロールに基づいて切り替わります。
```
<%@ OutputCache Duration="60" VaryByControl="State" %>
```

VaryByControls プロパティを使用して、ユーザーコントロールの複数のバージョンをプログラミングによってキャッシュするには

コード内に、それ自体へのポストバックを実行するユーザーコントロールコードを記述します。
ユーザーコントロールコードの先頭に、PartialCachingAttribute を組み込みます。
Duration パラメータに値を指定し、VaryByControls パラメータを、ユーザーコントロール出力を切り替えるときの基準とする、ユーザーコントロール内の ASP.NET サーバーコントロールの ID に設定します。

Duration を 60 秒に設定し、VaryByControls を State に設定するコード例を次に示します。このコードは、UserControl クラスを拡張するコードの前に置く必要があります。
```
[PartialCaching(60, null, State, null)]
```
```
<PartialCaching(60, null, State, null)>
```

VaryByParam 属性を使用して、ユーザーコントロールの複数のバージョンを宣言によってキャッシュするには

それ自体にポストバックするユーザーコントロールを作成します。

ユーザーコントロールに、Duration 属性と VaryByParam 属性を持つ @ OutputCache ディレクティブを含めます。

メモ :
ユーザーコントロールに対する @ OutputCache ディレクティブに VaryByControl 属性を指定した場合は、VaryByParam 属性を指定する必要はありません。

VaryByParam 属性に、ユーザーコントロールを切り替えるときの基準となる GET クエリ文字列パラメータまたはフォームの POST パラメータを設定します。

ユーザーコントロールの有効期限を 60 秒に設定し、コントロールの出力を State という名前のフォームの POST パラメータまたはクエリ文字列パラメータの値によって切り替える @ OutputCache ディレクティブの例を次に示します。
```
<%@ OutputCache Duration="60" VaryByParam="State" %>
```

VaryByParams プロパティを使用して、ユーザーコントロールの複数のバージョンをプログミングによってキャッシュするには

コード内に、それ自体へのポストバックを実行するユーザーコントロールコードを記述します。
ユーザーコントロールコードの先頭に、PartialCachingAttribute を組み込みます。
Duration パラメータに値を指定し、VaryByParams パラメータに、ユーザーコントロール出力を切り替える基準とする GET クエリ文字列パラメータまたはフォームの POST パラメータを設定します。

Duration を 60 秒に設定し、VaryByParams を State という名前のフォーム POST パラメータまたはクエリ文字列パラメータに設定するコード例を次に示します。このコードは、UserControl クラスを拡張するコードの前に置く必要があります。
```
[PartialCaching(60, State, null, null)]
```
```
<PartialCaching(60, State, null, null)>
```