CacheDependency Construtores

protected:
 CacheDependency();

protected CacheDependency ();

Protected Sub New ()

Exemplos

O exemplo de código a seguir é uma classe que implementa essa versão do CacheDependency construtor, pois todas as classes que derivam de CacheDependency são necessárias.

' Declare the class.
Public Class CustomCacheDependency 
   Inherits CacheDependency

     ' Constructor with no arguments 
     ' provided by CacheDependency class.
     Public Sub New()
     End Sub
   
     ' Declare a Boolean field named disposedValue.
     ' This will be used by Disposed property.
     Private disposedValue As Boolean                
     
     ' Create accessors for the Disposed property.
     Public Property Disposed As Boolean
       Get
           Return disposedValue
       End Get
       Set (ByVal value As Boolean)
           disposedValue = value
       End Set
     End Property
     
     ' Create a public method that sets the latest
     ' changed time of the CustomCacheDependency
     ' and notifies the underlying CacheDependency that the 
     ' dependency has changed, even though the HasChanged
     ' property is false.
     Public Sub ResetDependency()
        If Me.HasChanged = False              
           SetUtcLastModified(DateTime.MinValue)
           NotifyDependencyChanged(Me, EventArgs.Empty)
        End If
     End Sub
     
     ' Overrides the DependencyDispose method to set the
     ' Disposed proerty to true. This method automatically
     ' notifies the underlying CacheDependency object to 
     ' release any resources associated with this class. 
     Protected Overrides Sub DependencyDispose()
        Disposed = True
     End Sub
     
     
 End Class

Comentários

Se você quiser derivar sua própria classe de CacheDependency, implemente esta versão do CacheDependency construtor.

Confira também

• Cache
• Insert(String, Object, CacheDependency)
• Armazenando dados do aplicativo em cache

public:
 CacheDependency(System::String ^ filename);

public CacheDependency (string filename);

new System.Web.Caching.CacheDependency : string -> System.Web.Caching.CacheDependency

Public Sub New (filename As String)

Parâmetros

Exemplos

O exemplo de código a seguir cria uma instância da CacheDependency classe com uma dependência em um arquivo XML. Em Cache.Insert seguida, o Cache método adiciona um item ao que depende desse arquivo.

CacheDependency dep = new CacheDependency(Server.MapPath("isbn.xml"));
Cache.Insert("ISBNData", Source, dep);

Dim dep As New CacheDependency(Server.MapPath("isbn.xml"))
    Cache.Insert("ISBNData", Source, dep)

Você também pode usar a técnica a seguir para adicionar um item ao Cache com uma dependência em um arquivo.

// Make key1 dependent on a file.
CacheDependency dependency = new CacheDependency(Server.MapPath("isbn.xml"));

Cache.Insert("key1", "Value 1", dependency);

    ' Make key1 dependent on a file.
    Dim dependency as new CacheDependency(Server.MapPath("isbn.xml"))

    Cache.Insert("key1", "Value 1", dependency)
End If

Comentários

Se o diretório ou arquivo especificado no filename parâmetro não for encontrado no sistema de arquivos, ele será tratado como ausente. Se o diretório ou arquivo estiver ausente quando o objeto com a dependência for adicionado ao Cache, o objeto armazenado em cache será removido do Cache quando o diretório ou arquivo for criado.

Por exemplo, suponha que você adicione um objeto ao Cache com uma dependência no seguinte caminho de arquivo: c:\stocks\xyz.dat. Se esse arquivo não for encontrado quando o CacheDependency objeto for criado, mas for criado posteriormente, o objeto armazenado em cache será removido após a criação do arquivo xyz.dat.

Confira também

• Cache
• Armazenando dados do aplicativo em cache

public:
 CacheDependency(cli::array <System::String ^> ^ filenames);

public CacheDependency (string[] filenames);

new System.Web.Caching.CacheDependency : string[] -> System.Web.Caching.CacheDependency

Public Sub New (filenames As String())

Parâmetros

Exemplos

O exemplo de código a seguir demonstra como usar o Cache.Insert método para adicionar um item ao Cache com dependências em uma matriz de arquivos. Você também pode tornar o item dependente de uma matriz de diretórios.

    // Make key1 dependent on several files.
    String[] files = new String[2];
    files[0] = Server.MapPath("isbn.xml");
    files[1] = Server.MapPath("customer.xml");
    CacheDependency dependency = new CacheDependency(files);

    Cache.Insert("key1", "Value 1", dependency);
}

    ' Make key1 dependent on several files.
    Dim files(2) as String
    files(0) = Server.MapPath("isbn.xml")
    files(1) = Server.MapPath("customer.xml")
    Dim dependency as new CacheDependency(files)

    Cache.Insert("key1", "Value 1", dependency)
End If

Comentários

Se qualquer um dos arquivos ou diretórios na matriz for alterado ou removido da matriz, o item armazenado em cache ficará obsoleto e será removido do objeto do Cache aplicativo.

Além disso, se qualquer um dos diretórios ou arquivos especificados no filenames parâmetro não for encontrado no sistema de arquivos, ele será tratado como ausente. Se um diretório ou arquivo estiver ausente quando o objeto com a dependência for adicionado ao Cache, o objeto armazenado em cache será removido do Cache quando esse diretório ou arquivo for criado.

Por exemplo, suponha que você adicione um objeto ao Cache com uma dependência no seguinte caminho de arquivo: c:\stocks\xyz.dat. Se esse arquivo não for encontrado quando o CacheDependency objeto for criado, mas for criado posteriormente, o objeto armazenado em cache será removido após a criação do arquivo xyz.dat.

Confira também

• Cache
• Armazenando dados do aplicativo em cache

public:
 CacheDependency(System::String ^ filename, DateTime start);

public CacheDependency (string filename, DateTime start);

new System.Web.Caching.CacheDependency : string * DateTime -> System.Web.Caching.CacheDependency

Public Sub New (filename As String, start As DateTime)

Parâmetros

Exemplos

O exemplo de código a seguir usa esse construtor para instanciar um CacheDependency objeto e insere um item no Cache com essa dependência. O dt valor passado no start parâmetro é definido DateTime.Nowcomo .

// Insert the cache item.
CacheDependency dep = new CacheDependency(fileName, dt);
cache.Insert("key", "value", dep);

// Check whether CacheDependency.HasChanged is true.
if (dep.HasChanged)
  Response.Write("<p>The dependency has changed.");  
else Response.Write("<p>The dependency has not changed.");

' Insert the cache item.
Dim dep As New CacheDependency(fileName, dt)
myCache.Insert("key", "value", dep)

' Check whether CacheDependency.HasChanged is true.
If dep.HasChanged Then
   Response.Write("<p>The dependency has changed.")
Else
   Response.Write("<p>The dependency has not changed.")
End If 

Comentários

Se o diretório ou arquivo especificado no filename parâmetro não for encontrado no sistema de arquivos, ele será tratado como ausente. Se o diretório ou arquivo estiver ausente quando o objeto com a dependência for adicionado ao Cache, o objeto armazenado em cache será removido do Cache quando o diretório ou arquivo for criado.

Por exemplo, suponha que você adicione um objeto ao Cache com uma dependência no seguinte caminho de arquivo: c:\stocks\xyz.dat. Se esse arquivo não for encontrado quando o CacheDependency objeto for criado, mas for criado posteriormente, o objeto armazenado em cache será removido após a criação do arquivo xyz.dat.

Confira também

• Cache
• Insert(String, Object, CacheDependency)
• Armazenando dados do aplicativo em cache

public:
 CacheDependency(cli::array <System::String ^> ^ filenames, DateTime start);

public CacheDependency (string[] filenames, DateTime start);

new System.Web.Caching.CacheDependency : string[] * DateTime -> System.Web.Caching.CacheDependency

Public Sub New (filenames As String(), start As DateTime)

Parâmetros

Exemplos

O exemplo de código a seguir cria um CacheDependency objeto que passa dois arquivos XML e um DateTime.Now valor quando o objeto é incluído como um argumento de parâmetro em uma Cache.Insert chamada de método.

// Create a DateTime object that determines
// when dependency monitoring begins.
DateTime dt = DateTime.Now;
    // Make key1 dependent on several files.
    String[] files = new String[2];
    files[0] = Server.MapPath("isbn.xml");
    files[1] = Server.MapPath("customer.xml");
    CacheDependency dep = new CacheDependency(files, dt);

    Cache.Insert("key1", "Value 1", dep);
}

    ' Create a DateTime object that determines
    '  when dependency monitoring begins.
    Dim dt As DateTime = DateTime.Now

    ' Make key1 dependent on several files.
    Dim files(2) as String
    files(0) = Server.MapPath("isbn.xml")
    files(1) = Server.MapPath("customer.xml")
    Dim dependency as new CacheDependency(files, dt)

    Cache.Insert("key1", "Value 1", dependency)
End If

Comentários

Se qualquer um dos diretórios ou arquivos especificados no filenames parâmetro não for encontrado no sistema de arquivos, ele será tratado como ausente. Se um diretório ou arquivo estiver ausente quando o objeto com a dependência for adicionado ao Cache, o objeto armazenado em cache será removido do Cache quando esse diretório ou arquivo for criado.

Por exemplo, suponha que você adicione um objeto ao Cache com uma dependência no seguinte caminho de arquivo: c:\stocks\xyz.dat. Se esse arquivo não for encontrado quando o CacheDependency objeto for criado, mas for criado posteriormente, o objeto armazenado em cache será removido após a criação do arquivo xyz.dat.

Confira também

• Cache
• Armazenando dados do aplicativo em cache

public:
 CacheDependency(cli::array <System::String ^> ^ filenames, cli::array <System::String ^> ^ cachekeys);

public CacheDependency (string[] filenames, string[] cachekeys);

new System.Web.Caching.CacheDependency : string[] * string[] -> System.Web.Caching.CacheDependency

Public Sub New (filenames As String(), cachekeys As String())

Parâmetros

Exemplos

O fragmento de código a seguir demonstra como inserir um item no do Cache aplicativo com uma dependência de uma chave para outro item colocado no cache. Como esse método usa a sintaxe de matriz, você deve definir o número de chaves em que o item que você está adicionando ao Cache é dependente.

public void CreateDependency(Object sender, EventArgs e) {
    // Create a cache entry.
    Cache["key1"] = "Value 1";

    // Make key2 dependent on key1.
    String[] dependencyKey = new String[1];
    dependencyKey[0] = "key1";
    CacheDependency dependency = new CacheDependency(null, dependencyKey);

    Cache.Insert("key2", "Value 2", dependency);

    DisplayValues();
}

Public Sub CreateDependency(sender As Object, e As EventArgs)
    ' Create a cache entry.
    Cache("key1") = "Value 1"

    ' Make key2 dependent on key1.
    Dim dependencyKey(0) As String
    dependencyKey(0) = "key1"
    Dim dependency As new CacheDependency(Nothing, dependencyKey)

    Cache.Insert("key2", "Value 2", dependency)

    DisplayValues()
End Sub

Comentários

Além disso, se qualquer um dos diretórios ou arquivos especificados no filenames parâmetro não for encontrado no sistema de arquivos, ele será tratado como ausente. Se um diretório ou arquivo estiver ausente quando o objeto com a dependência for adicionado ao Cache, o objeto armazenado em cache será removido do Cache quando esse diretório ou arquivo for criado.

Por exemplo, suponha que você adicione um objeto ao Cache com uma dependência no seguinte caminho de arquivo: c:\stocks\xyz.dat. Se esse arquivo não for encontrado quando o CacheDependency objeto for criado, mas for criado posteriormente, o objeto armazenado em cache será removido após a criação do arquivo xyz.dat.

No entanto, a cachekeys dependência não funciona da mesma maneira. Se pelo menos um valor no cachekeys parâmetro não existir no momento de uma inserção, a inserção falhará. Observe que não há exceção gerada para esse cenário.

Confira também

• Cache
• Armazenando dados do aplicativo em cache

public:
 CacheDependency(cli::array <System::String ^> ^ filenames, cli::array <System::String ^> ^ cachekeys, DateTime start);

public CacheDependency (string[] filenames, string[] cachekeys, DateTime start);

new System.Web.Caching.CacheDependency : string[] * string[] * DateTime -> System.Web.Caching.CacheDependency

Public Sub New (filenames As String(), cachekeys As String(), start As DateTime)

Parâmetros

Exemplos

O exemplo de código a seguir cria um CreateDependency método . Quando esse método é chamado, ele cria um DateTime objeto e a Cache.Item[] propriedade é usada para adicionar um item ao cache com um key parâmetro de key1 e um valor de Value 1. Uma matriz de cadeias de caracteres, dependencyKey, é criada com o valor de key1 também. Esse CacheDependency construtor cria uma instância de um CacheDependency objeto que passa dependencyKey e o DateTime objeto como argumentos de parâmetro. O Cache.Insert método é chamado em seguida, usando o CacheDependency objeto como um parâmetro. Isso torna o objeto adicionado ao cache usando o Insert método dependente da key1 chave.

public void CreateDependency(Object sender, EventArgs e)
{
    // Create a DateTime object.
    DateTime dt = DateTime.Now.AddSeconds(10);

    // Create a cache entry.
    Cache["key1"] = "Value 1";

    // Make key2 dependent on key1.
    String[] dependencyKey = new String[1];
    dependencyKey[0] = "key1";
    CacheDependency dependency = new CacheDependency(null, dependencyKey, dt);

    Cache.Insert("key2", "Value 2", dependency);

    DisplayValues();
}

Public Sub CreateDependency(sender As Object, e As EventArgs)
' Create a DateTime object.
Dim dt as DateTime = DateTime.Now.AddSeconds(10)        

' Create a cache entry.
    Cache("key1") = "Value 1"

    ' Make key2 dependent on key1.
    Dim dependencyKey(0) As String
    dependencyKey(0) = "key1"
    Dim dependency As new CacheDependency(Nothing, dependencyKey, dt)

    Cache.Insert("key2", "Value 2", dependency)

    DisplayValues()
End Sub

Comentários

Além disso, se qualquer um dos diretórios ou arquivos especificados no filenames parâmetro não for encontrado no sistema de arquivos, ele será tratado como ausente. Se um diretório ou arquivo estiver ausente quando o objeto com a dependência for adicionado ao Cache, o objeto armazenado em cache será removido do Cache quando esse diretório ou arquivo for criado.

Por exemplo, suponha que você adicione um objeto ao Cache com uma dependência no seguinte caminho de arquivo: c:\stocks\xyz.dat. Se esse arquivo não for encontrado quando o CacheDependency objeto for criado, mas for criado posteriormente, o objeto armazenado em cache será removido após a criação do arquivo xyz.dat.

No entanto, a cachekeys dependência não funciona da mesma maneira. Se pelo menos um valor no cachekeys parâmetro não existir no momento de uma inserção, a inserção falhará. Observe que não há exceção gerada para esse cenário.

Confira também

• Cache
• Insert(String, Object, CacheDependency)
• Armazenando dados do aplicativo em cache

public:
 CacheDependency(cli::array <System::String ^> ^ filenames, cli::array <System::String ^> ^ cachekeys, System::Web::Caching::CacheDependency ^ dependency);

public CacheDependency (string[] filenames, string[] cachekeys, System.Web.Caching.CacheDependency dependency);

new System.Web.Caching.CacheDependency : string[] * string[] * System.Web.Caching.CacheDependency -> System.Web.Caching.CacheDependency

Public Sub New (filenames As String(), cachekeys As String(), dependency As CacheDependency)

Parâmetros

Exemplos

O exemplo de código a seguir cria um CreateDependency método . Quando esse método é chamado, ele usa a Cache.Item[] propriedade para adicionar um item ao cache com um key parâmetro de key1 e um valor de Value 1. Uma matriz de cadeias de caracteres, dependencyKey, é criada com o valor de key1 também. O CacheDependency.CacheDependency construtor é usado para criar um CacheDependency objeto , dep1que passa dependencyKey como um argumento de parâmetro. Um segundo CacheDependency objeto, dep2, é criado usando esse construtor, com dep1 passado como o terceiro argumento de parâmetro. Essa segunda dependência depende da primeira. O Cache.Insert método é chamado em seguida, usando o segundo CacheDependency objeto como um parâmetro. Se a primeira dependência for alterada de alguma forma, o item armazenado em cache será invalidado.

public void CreateDependency(Object sender, EventArgs e) {
    // Create a cache entry.
    Cache["key1"] = "Value 1";

    // Make key2 dependent on key1.
    String[] dependencyKey = new String[1];
    dependencyKey[0] = "key1";
    CacheDependency dep1 = new CacheDependency(null, dependencyKey);

    // Make a second CacheDependency dependent on dep1.        
    CacheDependency dep2 = new CacheDependency(null, null, dep1);

    Cache.Insert("key2", "Value 2", dep2);

    DisplayValues();
}

 Public Sub CreateDependency(sender As [Object], e As EventArgs)
   ' Create a cache entry.
   Cache("key1") = "Value 1"

   ' Make key2 dependent on key1 using double dependency.
   Dim dependencyKey(0) As [String]
   dependencyKey(0) = "key1"
   Dim dep1 As New CacheDependency(Nothing, dependencyKey)

   ' Make a second CacheDependency dependent on dep1.        
   Dim dep2 As New CacheDependency(Nothing, Nothing, dep1)

   Cache.Insert("key2", "Value 2", dep2)

   DisplayValues()
End Sub 'CreateDependency

Comentários

Além disso, se qualquer um dos diretórios ou arquivos especificados no filenames parâmetro não for encontrado no sistema de arquivos, ele será tratado como ausente. Se um diretório ou arquivo estiver ausente quando o objeto com a dependência for adicionado ao Cache, o objeto armazenado em cache será removido do Cache quando esse diretório ou arquivo for criado.

Por exemplo, suponha que você adicione um objeto ao Cache com uma dependência no seguinte caminho de arquivo: c:\stocks\xyz.dat. Se esse arquivo não for encontrado quando o CacheDependency objeto for criado, mas for criado posteriormente, o objeto armazenado em cache será removido após a criação do arquivo xyz.dat.

No entanto, a cachekeys dependência não funciona da mesma maneira. Se pelo menos um valor no cachekeys parâmetro não existir no momento de uma inserção, a inserção falhará. Observe que não há exceção gerada para esse cenário.

public:
 CacheDependency(cli::array <System::String ^> ^ filenames, cli::array <System::String ^> ^ cachekeys, System::Web::Caching::CacheDependency ^ dependency, DateTime start);

public CacheDependency (string[] filenames, string[] cachekeys, System.Web.Caching.CacheDependency dependency, DateTime start);

new System.Web.Caching.CacheDependency : string[] * string[] * System.Web.Caching.CacheDependency * DateTime -> System.Web.Caching.CacheDependency

Public Sub New (filenames As String(), cachekeys As String(), dependency As CacheDependency, start As DateTime)

Parâmetros

Exemplos

O exemplo de código a seguir mostra um CreateDependency método . Quando esse método é chamado, ele cria um DateTime objeto e a Cache.Item[] propriedade é usada para adicionar um item ao cache com um parâmetro de chave de key1 e um valor de Value 1. Uma matriz de cadeias de caracteres, dependencyKey, é criada com o valor em seu primeiro índice (e somente) definido como o valor de key1 também. Em CacheDependency.CacheDependency seguida, o construtor é usado para criar um CacheDependency objeto , dep1que passa dependencyKey como um argumento de parâmetro. Um segundo CacheDependency objeto, dep2, é criado usando esse construtor, com dep1 e o DateTime objeto passado como argumentos de parâmetro. Essa segunda dependência depende do primeiro, e o monitoramento de dependência começará 10 segundos depois que o CreateDependency método for chamado. O Cache.Insert método é chamado em seguida, usando o segundo CacheDependency objeto como um parâmetro. Se a primeira dependência for alterada de alguma forma, o item armazenado em cache será invalidado.

public void CreateDependency(Object sender, EventArgs e) {
    // Create a DateTime object.
    DateTime dt = DateTime.Now.AddSeconds(10);

    // Create a cache entry.
    Cache["key1"] = "Value 1";

    // Make key2 dependent on key1.
    String[] dependencyKey = new String[1];
    dependencyKey[0] = "key1";
    CacheDependency dep1 = new CacheDependency(null, dependencyKey);

    // Make a second CacheDependency dependent on dep1.
    // and use dt to start change monitoring.        
    CacheDependency dep2 = new CacheDependency(null, null, dep1, dt);

    Cache.Insert("key2", "Value 2", dep2);

    DisplayValues();
}

 Public Sub CreateDependency(sender As [Object], e As EventArgs)
   ' Create a DateTime object.
   Dim dt as DateTime = DateTime.Now.AddSeconds(10)        

   ' Create a cache entry.
   Cache("key1") = "Value 1"

   ' Make key2 dependent on key1 using double dependency.
   Dim dependencyKey(0) As [String]
   dependencyKey(0) = "key1"
   Dim dep1 As New CacheDependency(Nothing, dependencyKey)

   ' Make a second CacheDependency dependent on dep1
   ' and use dt to start change monitoring.        
   Dim dep2 As New CacheDependency(Nothing, Nothing, dep1, dt)

   Cache.Insert("key2", "Value 2", dep2)

   DisplayValues()
End Sub 'CreateDependency

Comentários

Além disso, se qualquer um dos diretórios ou arquivos especificados no filenames parâmetro não for encontrado no sistema de arquivos, ele será tratado como ausente. Se um diretório ou arquivo estiver ausente quando o objeto com a dependência for adicionado ao Cache, o objeto armazenado em cache será removido do Cache quando esse diretório ou arquivo for criado.

Por exemplo, suponha que você adicione um objeto ao Cache com uma dependência no seguinte caminho de arquivo: c:\stocks\xyz.dat. Se esse arquivo não for encontrado quando o CacheDependency objeto for criado, mas for criado posteriormente, o objeto armazenado em cache será removido após a criação do arquivo xyz.dat.

No entanto, a cachekeys dependência não funciona da mesma maneira. Se pelo menos um valor no cachekeys parâmetro não existir no momento de uma inserção, a inserção falhará. Observe que não há exceção gerada para esse cenário.

Confira também

• Cache
• Insert(String, Object, CacheDependency)
• Armazenando dados do aplicativo em cache