HttpResponse.AddCacheItemDependency(String) Methode

Referenz

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Macht die Gültigkeit einer zwischengespeicherten Antwort von einem anderen Element im Cache abhängig.

public:
 void AddCacheItemDependency(System::String ^ cacheKey);

public void AddCacheItemDependency (string cacheKey);

member this.AddCacheItemDependency : string -> unit

Public Sub AddCacheItemDependency (cacheKey As String)

Parameter

cacheKey: String

Der Schlüssel des Elements, von dem die zwischengespeicherte Antwort abhängt.

Beispiele

Das folgende Beispiel ist ein ASP.NET Benutzersteuerelement, das zwischengespeichert wird. Der Code für das Steuerelement ruft die AddCacheItemDependency -Methode mit dem Schlüssel eines Elements auf, das im -Objekt gespeichert ist, das Cache als Parameter übergeben wird. Wenn das Element nicht im Cache vorhanden ist, wird die Im Ausgabecache gespeicherte Antwort des Steuerelements ungültig. Dies bedeutet, dass in der nachfolgenden Anforderung dem Ausgabecache eine neue Version der Antwort des Steuerelements hinzugefügt wird.

Als Nächstes überprüft der Code, ob ein Element, das Cache einem bookData Schlüssel zugeordnet ist, im -Objekt gespeichert ist, und zeigt eine von zwei Textzeilen an, die vom Ergebnis abhängig sind. Anschließend legt der Code die DataSource -Eigenschaft eines DataGrid -Steuerelements mit dem Namen dgBooksmit einem Aufruf der freigegebenen GetBookData Methode einer benutzerdefinierten DataHelper Klasse fest und füllt die DataGrid mit der DataBind -Methode auf.

    <%@ Control Language="c#" %>
    <%@ Outputcache duration="10" varybyparam="none" shared="True" %>
    <%@ Import Namespace = "Samples.AspNet.CS" %>
    <%@ Import Namespace = "System.Data" %>

<script runat="server">

    private void Page_Load(object sender, System.EventArgs e)
    {
    
        // Make user control invalid if the
        // cache item changes or expires.
        Response.AddCacheItemDependency("bookData");

        // Create a DataView object.
        DataView source = (DataView)Cache["bookData"];
    
        // Check if the view is stored in the cache
        // and generate the right label text
        // dependent upon what is returned.
        if (source == null)
        {
            source = DataHelper.GetBookData();
            lblCacheMsg.Text = "Data generated explicitly.";
        }
        else
        {
            lblCacheMsg.Text = "Data retrieved from application cache.";
        }
    
        dgBooks.DataSource = source;
        dgBooks.DataBind();
    
        lblOutputMessage.Text = DateTime.Now.ToString();
    }

</script>
    <table>
        <tbody>
            <tr>
                <th>
                    Books</th>
                <td>
                </td>
            </tr>
            <tr>
                <td>
                    <asp:DataGrid id="dgBooks" runat="server"></asp:DataGrid>
                </td>
                <td>
                </td>
            </tr>
            <tr>
                <td>
                    <asp:Label id="lblCacheMsg" runat="server"></asp:Label>
                </td>
                <td>
                </td>
            </tr>
            <tr>
                <td>
                    The control was created at: 
                </td>
                <td>
                    <asp:Label id="lblOutputMessage" runat="server"></asp:Label>
                </td>
            </tr>
        </tbody>
    </table>

<%@ Control Language="vb" %>
<%@ Outputcache duration="10" varybyparam="none" shared="True" %>
<%@ Import Namespace="Samples.AspNet.VB" %>
<%@ Import Namespace="System.Data" %>
<script runat="server">

    Private Sub Page_Load(sender As Object, e As System.EventArgs)
    
        ' Make user control invalid if the 
        ' cache item changes or expires.
        Response.AddCacheItemDependency("bookData")


        ' Create a DataView object.
        Dim source As DataView = Cache("bookData")
    
        ' Check if the view is stored in the cache
        ' and generate the right label text
        ' dependent upon what is returned.
        If source Is Nothing Then

           source = DataHelper.GetBookData()
           lblCacheMsg.Text = "Data generated explicitly."
        Else
           lblCacheMsg.Text = "Data retrieved from application cache."
        End If
    
        dgBooks.DataSource = source
        dgBooks.DataBind()
    
        lblOutputMessage.Text = DateTime.Now.ToString()
    End Sub

</script>

    <table>
        <tbody>
            <tr>
                <th>
                    Books</th>
                <td>
                </td>
            </tr>
            <tr>
                <td>
                    <asp:DataGrid id="dgBooks" runat="server"></asp:DataGrid>
                </td>
                <td>
                </td>
            </tr>
            <tr>
                <td>
                    <asp:Label id="lblCacheMsg" runat="server"></asp:Label>
                </td>
                <td>
                </td>
            </tr>
            <tr>
                <td>
                    The control was created at: 
                </td>
                <td>
                    <asp:Label id="lblOutputMessage" runat="server"></asp:Label>
                </td>
            </tr>
        </tbody>
    </table>

Hinweise

Wenn das Element, das dem cacheKey Parameter entspricht, aus dem Cache entfernt wird, ist die zwischengespeicherte Antwort des aktuellen Elements ungültig.

Gilt für:

Freigeben über