httpEquiv property
[This documentation is preliminary and is subject to change.]
Gets or sets information used to bind the value of a content attribute of a meta element to an HTTP response header.
Syntax
HRESULT value = object.put_httpEquiv(BSTR v);HRESULT value = object.get_httpEquiv(BSTR* p);
Property values
Type: BSTR
the information in the response header. See HTTP Response Headers for a list of possible values.
Standards information
- Document Object Model (DOM) Level 1 Specification, Section 2.5.5
- HTML 4.01 Specification, Section 7.4.4
Remarks
If the property is omitted, the IHTMLMetaElement::name property should be used to identify the meta-information. The IHTMLMetaElement::httpEquiv property is not case-sensitive.
Developers using the IHTMLMetaElement::httpEquiv and content attributes to refresh documents from alternate URLs should treat the value of content as untrusted data. For more information, please see Security Considerations: Dynamic HTML.
As of Windows Internet Explorer 8, the IHTMLMetaElement::httpEquiv attribute also supports a value of x-ua-compatible
, which allows developers to specify the document compatibility mode that Windows Internet Explorer should use to display a webpage. To do this, set the content attribute to a BSTR value containing a comma-delimited list of one or more of the following values.
Value | Description |
IE=9 |
The webpage is displayed in IE9 Standards mode. |
IE=8 |
The webpage is displayed in IE8 Standards mode. |
IE=7 |
The webpage is displayed in IE7 Standards mode. |
IE=5 |
The webpage is displayed in IE5 (Quirks) mode. |
IE=EmulateIE9 |
If the webpage specifies a standards-based IHTMLDocument5::doctype directive, the page is displayed in IE9 mode; otherwise, it is displayed in IE5 mode. |
IE=EmulateIE8 |
If the webpage specifies a standards-based IHTMLDocument5::doctype directive, the page is displayed in IE8 mode; otherwise, it is displayed in IE5 mode. |
IE=EmulateIE7 |
If the webpage specifies a standards-based IHTMLDocument5::doctype directive, the page is displayed in IE7 mode; otherwise, it is displayed in IE5 mode. |
IE=Edge |
The webpage is displayed in the highest mode available to the version of Internet Explorer used to view the page. This option is generally intended for testing purposes. |
When the content attribute specifies multiple document modes, Internet Explorer displays the page in the highest mode supported by the browser. For more information, see Defining Document Compatibility.
See also
Reference
Conceptual
Defining Document Compatibility
Build date: 6/12/2012