WebMethodAttribute.CacheDuration プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

WebMethodAttribute.CacheDuration プロパティ

応答をキャッシュ内に保持する秒数を取得または設定します。

名前空間: System.Web.Services
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文

Visual Basic (宣言)

Public Property CacheDuration As
 Integer

Visual Basic (使用法)

Dim instance As WebMethodAttribute
Dim value As Integer

value = instance.CacheDuration

instance.CacheDuration = value

public int CacheDuration { get;
 set; }

C++

public:
property int CacheDuration {
    int get ();
    void set (int value);
}

/** @property */
public int get_CacheDuration ()

/** @property */
public void set_CacheDuration (int
 value)

JScript

public function get CacheDuration
 () : int

public function set CacheDuration
 (value : int)

プロパティ値
応答をキャッシュ内に保持する秒数。既定値は 0 です。応答がキャッシュされていないことを示します。

解説

キャッシングを有効にすると、要求と応答はサーバーのメモリに少なくともキャッシュの存続期間中は保持されるため、要求または応答のデータが大量の場合、または要求が大きく変更される場合は注意が必要です。

ASP.NET 2.0 Web サービスアプリケーションの出力キャッシュに影響を及ぼす可能性がある問題が 2 つあります。

ASP.NET 2.0 では、テストページの HTTP メソッドが GET から POST に変更されました。しかし、通常、POST はキャッシュされません。GET を使用するように ASP.NET 2.0 Web サービスアプリケーションのテストページを変更すれば、キャッシュは正常に動作します。

また、HTTP では、ユーザーエージェント (ブラウザまたは呼び出し元アプリケーション) で、"Cache-Control" を "no-cache" に設定することによってサーバーのキャッシュ機能をオーバーライドできる必要があることが示されています。このため ASP.NET アプリケーションでは、"no-cache" ヘッダーを見つけた場合に、キャッシュされた結果を無視します。

使用例

ServiceUsage XML Web サービスメソッドを呼び出した結果を、キャッシュ内に 60 秒間格納する例を次に示します。その 60 秒間に、XML Web サービスクライアントが ServiceUsage XML Web サービスメソッドを実行すると、常に同じ結果が返されます。

Visual Basic

<%@ WebService Language="VB" Class="Counter"
 %>

Imports System.Web.Services
Imports System
Imports System.Web

Public Class Counter
    Inherits WebService  

    <WebMethod(Description := "Number of times this service
 has been accessed", _
        CacheDuration := 60, _
        MessageName := "ServiceUsage")> _
    Public Function ServiceUsage() As
 Integer
        
        ' If the XML Web service has not been accessed, initialize it
 to 1.
        If Application("MyServiceUsage")
 Is Nothing Then
            Application("MyServiceUsage") = 1
        Else
            ' Increment the usage count.
            Application("MyServiceUsage") = CInt(Application("MyServiceUsage"))
 + 1
        End If
        
        ' Return the usage count.
        Return CInt(Application("MyServiceUsage"))
    End Function
End Class

<%@ WebService Language="C#" Class="Counter" %>

using System.Web.Services;
using System;
using System.Web;

public class Counter : WebService {
     
     [ WebMethod(Description="Number of times this service
 has been accessed",
     CacheDuration=60,MessageName="ServiceUsage") ]
     public int ServiceUsage() {
          // If the XML Web service has not been accessed, initialize
 it to 1.
          if (Application["MyServiceUsage"] == null)
 {
              Application["MyServiceUsage"] = 1;
          }
          else {
              // Increment the usage count.
              Application["MyServiceUsage"] = ((int)
 Application["MyServiceUsage"]) + 1;
          }

          // Return the usage count.     
          return  (int) Application["MyServiceUsage"];
     }
}