VirtualPathProvider.GetCacheDependency メソッドとは何？わかりやすく解説 Weblio辞書

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

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

VirtualPathProvider.GetCacheDependency メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した仮想パスに基づいてキャッシュの依存関係を作成します。

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

Visual Basic (宣言)

Public Overridable Function
 GetCacheDependency ( _
    virtualPath As String, _
    virtualPathDependencies As IEnumerable, _
    utcStart As DateTime _
) As CacheDependency

Visual Basic (使用法)

Dim instance As VirtualPathProvider
Dim virtualPath As String
Dim virtualPathDependencies As IEnumerable
Dim utcStart As DateTime
Dim returnValue As CacheDependency

returnValue = instance.GetCacheDependency(virtualPath, virtualPathDependencies, utcStart)

public virtual CacheDependency GetCacheDependency (
    string virtualPath,
    IEnumerable virtualPathDependencies,
    DateTime utcStart
)

C++

public:
virtual CacheDependency^ GetCacheDependency (
    String^ virtualPath, 
    IEnumerable^ virtualPathDependencies, 
    DateTime utcStart
)

public CacheDependency GetCacheDependency (
    String virtualPath, 
    IEnumerable virtualPathDependencies, 
    DateTime utcStart
)

JScript

public function GetCacheDependency (
    virtualPath : String, 
    virtualPathDependencies : IEnumerable, 
    utcStart : DateTime
) : CacheDependency

パラメータ

virtualPath: プライマリ想リソースへのパス。

virtualPathDependencies: プライマリ仮想リソースで必要な他のリソースへのパスの配列。

utcStart: 仮想リソースが読み取られた UTC 時刻。

戻り値
指定した仮想リソースの CacheDependency オブジェクト。

解説

GetCacheDependency メソッドの既定の実装では null 参照 (Visual Basic では Nothing) を返します。後で使用できるように仮想リソースをキャッシュするには、GetCacheDependency メソッドまたは GetFileHash メソッドをオーバーライドする必要があります。

使用例

VirtualPathProvider カスタムクラスの GetCacheDependency メソッドの実装例を次のコード例に示します。例の実行に必要なコード全体については、VirtualPathProvider クラスの概要のトピックで「例」を参照してください。

Visual Basic

Public Overrides Function
 GetCacheDependency(ByVal virtualPath As String,
 ByVal virtualPathDependencies As IEnumerable, ByVal utcStart As Date)
 As CacheDependency
  If (IsPathVirtual(virtualPath)) Then

    Dim fullPathDependencies As System.Collections.Specialized.StringCollection
    fullPathDependencies = Nothing

    ' Get the full path to all dependencies.
    For Each virtualDependency As
 String In virtualPathDependencies
      If fullPathDependencies Is Nothing
 Then
        fullPathDependencies = New System.Collections.Specialized.StringCollection
      End If

      fullPathDependencies.Add(virtualDependency)
    Next

    If fullPathDependencies Is Nothing
 Then
      Return Nothing
    End If

    Dim fullPathDependenciesArray As String()
    fullPathDependencies.CopyTo(fullPathDependenciesArray, 0)

    Return New CacheDependency(fullPathDependenciesArray,
 utcStart)
  Else
    Return Previous.GetCacheDependency(virtualPath, virtualPathDependencies,
 utcStart)
  End If
End Function

public override CacheDependency GetCacheDependency(
  string virtualPath, 
  System.Collections.IEnumerable virtualPathDependencies, 
  DateTime utcStart)
{
  if (IsPathVirtual(virtualPath))
  {
    System.Collections.Specialized.StringCollection fullPathDependencies = null;

    // Get the full path to all dependencies.
    foreach (string virtualDependency in
 virtualPathDependencies)
    {
      if (fullPathDependencies == null)
        fullPathDependencies = new System.Collections.Specialized.StringCollection();

      fullPathDependencies.Add(virtualDependency);
    }
    if (fullPathDependencies == null)
      return null;

    // Copy the list of full-path dependencies into an array.
    string[] fullPathDependenciesArray = new
 string[fullPathDependencies.Count];
    fullPathDependencies.CopyTo(fullPathDependenciesArray, 0);
    // Copy the virtual path into an array.
    string[] virtualPathArray = new string[1];
    virtualPathArray[0] = virtualPath;

    return new CacheDependency(virtualPathArray,
 fullPathDependenciesArray, utcStart);
  }
  else
    return Previous.GetCacheDependency(virtualPath, virtualPathDependencies,
 utcStart);
}