HttpCachePolicy.AddValidationCallback メソッド

  • リファレンス

定義

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

現在の応答の検証コールバックを登録します。

public:
 void AddValidationCallback(System::Web::HttpCacheValidateHandler ^ handler, System::Object ^ data);
public void AddValidationCallback (System.Web.HttpCacheValidateHandler handler, object data);
member this.AddValidationCallback : System.Web.HttpCacheValidateHandler * obj -> unit
Public Sub AddValidationCallback (handler As HttpCacheValidateHandler, data As Object)

パラメーター

handler
HttpCacheValidateHandler

HttpCacheValidateHandler 値。

data
Object

ユーザーが指定した、AddValidationCallback(HttpCacheValidateHandler, Object) デリゲートに戻される任意のデータ。

例外

ArgumentNullException

指定された handler は null です。

例

次のコード例は、クエリ文字列値に基づいて要求を検証するデリゲートを追加する方法を示しています。

<%@ Page Language="C#" %>
<%@ OutputCache VaryByParam="none" Duration="600" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script language="c#" runat="server">

   static string validationstate;
 
   public void Page_Load()
   {
      Response.Cache.AddValidationCallback(new HttpCacheValidateHandler(ValidateCache), null);
      stamp.InnerHtml = DateTime.Now.ToString("r");
   }

   public static void ValidateCache(HttpContext context, Object data, ref HttpValidationStatus status) 
   {
      if (context.Request.QueryString["Valid"] == "false") 
      {
         status = HttpValidationStatus.Invalid;
      } 
      else if (context.Request.QueryString["Valid"] == "ignore") 
      {
         status = HttpValidationStatus.IgnoreThisRequest;
      } 
      else 
      {
         status = HttpValidationStatus.Valid;
      }
   }

</script>

<%@ Page Language="VB" %>
<%@ OutputCache VaryByParam="none" Duration="600" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
   shared validationstate As String

   Public Sub Page_Load(sender As Object, e As EventArgs)
      Response.Cache.AddValidationCallback(new HttpCacheValidateHandler(AddressOf Me.ValidateCache), nothing)
      stamp.InnerHtml = DateTime.Now.ToString("r")
   End Sub

   Public Shared Sub ValidateCache(context As HttpContext, data As Object, ByRef status as HttpValidationStatus)
      If (context.Request.QueryString("Valid") = "false") Then
         status = HttpValidationStatus.Invalid
      Elseif (context.Request.QueryString("Valid") = "ignore") Then
         status = HttpValidationStatus.IgnoreThisRequest
      Else
         status = HttpValidationStatus.Valid
      End If
   End Sub

</script>

注釈

このメソッドは AddValidationCallback 、応答が出力キャッシュによってクライアントに返される前に、キャッシュ内でプログラムによって応答を確認するメカニズムを提供します。

Web サーバー キャッシュから応答を処理する前に、登録されているすべてのハンドラーに対してクエリが実行され、リソースの有効性が確保されます。 いずれかのハンドラーが、キャッシュされた応答が無効であることを示すフラグを設定した場合、エントリは無効としてマークされ、キャッシュから除外されます。 この場合、この要求に対してキャッシュされた応答を無視する必要があることをハンドラーが示す場合と同様に、要求はキャッシュ ミスであるかのように処理されます。

AddValidationCallbackは、.NET Framework バージョン 3.5 で導入されています。 詳細については、「.NET Framework のバージョンおよび依存関係」を参照してください。

適用対象