HttpCapabilitiesBase.SupportsCacheControlMetaTag Property

Reference

Definition

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets a value indicating whether the browser supports the cache-control value for the http-equiv attribute of HTML <meta> elements.

public:
 virtual property bool SupportsCacheControlMetaTag { bool get(); };

public virtual bool SupportsCacheControlMetaTag { get; }

member this.SupportsCacheControlMetaTag : bool

Public Overridable ReadOnly Property SupportsCacheControlMetaTag As Boolean

Property Value

Boolean

true if the browser supports the cache-control value for the http-equiv attribute of HTML <meta> elements; otherwise, false. The default is true.

Examples

The following code example shows how to determine whether the browser supports the cache-control value for the http-equiv attribute of HTML <meta> elements.

<%@ page language="C#"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    void Page_Load(Object Sender, EventArgs e)
    {
        CheckBrowserCaps();
    }

    void CheckBrowserCaps()
    {
        String labelText = "";
        System.Web.HttpBrowserCapabilities myBrowserCaps = Request.Browser;
        if (((System.Web.Configuration.HttpCapabilitiesBase)myBrowserCaps).SupportsCacheControlMetaTag)
        {
            labelText = "Browser supports the CACHE-CONTROL value for the HTTP-EQUIV attribute of HTML META elements.";
        }
        else
        {
            labelText = "Browser does not support the CACHE-CONTROL value for the HTTP-EQUIV attribute of HTML META elements.";
        }

        Label1.Text = labelText;
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Browser Capabilities Sample</title>
</head>
<body>
    <form runat="server" id="form1">
        <div>
            Browser Capabilities:
            <p/><asp:Label ID="Label1" Runat="server" />
        </div>
    </form>
</body>
</html>

<%@ page language="VB" %>

<!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(ByVal sender As Object, ByVal e As System.EventArgs)
        CheckBrowserCaps()
    End Sub

    Function CheckBrowserCaps()

        Dim labelText As String = ""
        Dim myBrowserCaps As System.Web.HttpBrowserCapabilities = Request.Browser
        If (CType(myBrowserCaps, System.Web.Configuration.HttpCapabilitiesBase)).SupportsCacheControlMetaTag Then
            labelText = "Browser supports the CACHE-CONTROL value for the HTTP-EQUIV attribute of HTML META elements."
        Else
            labelText = "Browser does not support the CACHE-CONTROL value for the HTTP-EQUIV attribute of HTML META elements."
        End If

        Label1.Text = labelText

    End Function 'CheckBrowserCaps
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Browser Capabilities Sample</title>
</head>
<body>
    <form runat="server" id="form1">
        <div>
            Browser Capabilities:
            <p/><asp:Label ID="Label1" Runat="server" />
        </div>
    </form>
</body>
</html>

Remarks

The cache-control value for the http-equiv attribute of HTML <meta> elements allows control over client caching of downloaded content, which includes Web pages. The following HTML fragment shows an example:

<META HTTP-EQUIV="CACHE-CONTROL" CONTENT="NO-CACHE"/>

If true, the inclusion of this tag in the <head> element of a Web page should force the browser to reload content from the server.

If false, server control adapters append a default query string (__ufps=``uniquefilepathsuffix) onto link URL values that do not already have one. This forces the browser to reload content from the server.

The SupportsCacheControlMetaTag property also applies to the equivalent HTTP header form:

CACHE-CONTROL: NO-CACHE

Applies to

Share via