HttpApplication.GetOutputCacheProviderName(HttpContext) メソッド

  • リファレンス

定義

名前空間:
System.Web
アセンブリ:
System.Web.dll

Web サイトに対して構成されている既定の出力キャッシュ プロバイダーの名前を取得します。

public:
 virtual System::String ^ GetOutputCacheProviderName(System::Web::HttpContext ^ context);
public virtual string GetOutputCacheProviderName (System.Web.HttpContext context);
abstract member GetOutputCacheProviderName : System.Web.HttpContext -> string
override this.GetOutputCacheProviderName : System.Web.HttpContext -> string
Public Overridable Function GetOutputCacheProviderName (context As HttpContext) As String

パラメーター

context
HttpContext

HTTP 要求を処理するために使用される組み込みサーバー オブジェクトへの参照を提供する HttpContext。

戻り値

String

既定のプロバイダーの名前。

例外

ProviderException

context は null または空の文字列です。

例

次の例は、Advanced.aspx ページに移動する HTTP 要求に対して という名前 DiskCache のキャッシュ プロバイダーをプログラムで指定する方法を示しています。

public override string GetOutputCacheProviderName(HttpContext context)  
{  
    if (context.Request.Path.EndsWith("Advanced.aspx"))  
        return "DiskCache";  
    else  
        return base.GetOutputCacheProviderName(context);  
}  

Public Overloads Overrides Sub GetOutputCacheProviderName(ByVal context _  
        As HttpContext) As String   
    If context.Request.Path.EndsWith("Advanced.aspx") Then   
        Return "DiskCache"   
    Else   
        Return MyBase.GetOutputCacheProviderName(context)   
    End If   
End Sub

注釈

このメソッドをオーバーライドし、それを使用して、Web サイト用に構成されている出力キャッシュ プロバイダーの名前を返すことができます。 ASP.NET は、名前付きプロバイダーへの参照を取得し、それを使用して、現在実行中の要求の出力キャッシュ データを格納します。

既定では、ASP.NET では、すべての HTTP 応答、レンダリングされたページ、およびコントロールでメモリ内出力キャッシュが使用されます。 に別のプロバイダー名 defaultProviderを指定することで、Web アプリケーションに使用される既定の出力キャッシュ プロバイダーを変更できます。

さらに、個々の制御と個々の要求に対して、異なる出力キャッシュ プロバイダーを選択できます。 Web ユーザー コントロールごとに異なる出力キャッシュ プロバイダーを選択する最も簡単な方法は、次の例に示すように、ページまたはコントロール ディレクティブで新しい providerName 属性を使用して宣言的に行うことです。

<%@ OutputCache Duration="60" VaryByParam="None"   
    providerName="DiskCache" %>

HTTP 要求に別の出力キャッシュ プロバイダーを指定するには、Global.asax ファイルでこのメソッドをオーバーライドして、特定の要求に使用するプロバイダーをプログラムで指定します。 詳細については、「ASP.NET のキャッシュの概要」を参照してください。

適用対象