HttpResponse.AddCacheDependency(CacheDependency[]) Método

Definição

Espaço de Nomes:
System.Web
Assemblagem:
System.Web.dll

Associa um conjunto de dependências de cache à resposta para facilitar a invalidação da resposta se esta estiver armazenada na cache de saída e as dependências especificadas mudarem.

public:
 void AddCacheDependency(... cli::array <System::Web::Caching::CacheDependency ^> ^ dependencies);
public void AddCacheDependency(params System.Web.Caching.CacheDependency[] dependencies);
member this.AddCacheDependency : System.Web.Caching.CacheDependency[] -> unit
Public Sub AddCacheDependency (ParamArray dependencies As CacheDependency())

Parâmetros

dependencies
CacheDependency[]

Um ficheiro, chave de cache, ou CacheDependency para adicionar à lista de dependências da aplicação.

Exceções

ArgumentNullException

O dependencies parâmetro é null.

InvalidOperationException

Este método foi chamado demasiado tarde no pipeline de processamento de cache, depois de a resposta em cache já ter sido criada.

Exemplos

O exemplo seguinte demonstra como criar uma dependência de cache usando o AddCacheDependency método e um CacheDependency objeto.

<%@ Page Language="C#" %>
<%@ outputcache duration="30" varybyparam="none" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="Server">
    private void Page_Load(object sender, System.EventArgs e)
    {
        // Create a Cache Dependency 
        // using a CacheDependency object.
        CacheDependency authorsDependency = new CacheDependency("authors.xml");


        // Make the page invalid if either of the
        // cached items change or expire.        
        Response.AddCacheDependency(authorsDependency);

        // Display the current time for cache reference
        lblOutputCacheMsg.Text = DateTime.Now.ToString();
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Cache Dependencies</title> 
</head>
<body>
    <form id="Form1" method="post" runat="server">
        <table>
            <tbody>
                <tr>
                    <td style="WIDTH: 118px">
                        The page was generated at:</td>
                    <td>
                        <asp:Label id="lblOutputCacheMsg" runat="server"></asp:Label>
                    </td>
                </tr>
            </tbody>
        </table>
    </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ outputcache duration="30" varybyparam="none" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="Server">
    Sub Page_Load()
        ' Create a Cache Dependency 
        ' using a CacheDependency object.
        Dim authorsDependency("authors.xml") As CacheDependency

        ' Make the page invalid if either of the
        ' cached items change or expire.        
        Response.AddCacheDependency(authorsDependency)

        ' Display the current time for cache reference
        lblOutputCacheMsg.Text = DateTime.Now.ToString()
        
        
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Cache Dependencies</title> 
</head>
<body>
    <form id="Form1" method="post" runat="server">
        <table>
            <tbody>
                <tr>
                    <td style="WIDTH: 118px">
                        The page was generated at:</td>
                    <td>
                        <asp:Label id="lblOutputCacheMsg" runat="server"></asp:Label>
                    </td>
                </tr>
            </tbody>
        </table>
    </form>
</body>
</html>

Observações

O AddCacheDependency método permite criar dependências entre respostas em cache e um CacheDependency objeto.

Aplica-se a

Ver também