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
- content
- meta
- Conceptual
- Defining Document Compatibility
Build date: 6/12/2012
