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 のキャッシュの概要」を参照してください。