name property

  • Article

[This documentation is preliminary and is subject to change.]

Sets or retrieves the name of the object.

HTML 4.01 Specification, Section 17.3

Syntax

HRESULT value = object.put_name(BSTR v);HRESULT value = object.get_name(BSTR* p);

Property values

Type: BSTR

the name.

Standards information

Remarks

When you submit a form, use the IHTMLDOMAttribute2::name property to bind the value of the control.

The name is not the value that is displayed for the input type=button, input type=reset, and input type=submit input types. The internally stored value is submitted with the form, not the displayed value.

Windows Internet Explorer 8 and later. In IE8 Standards mode, dynamically setting the IHTMLDOMAttribute2::name attribute on an input type=radio button correctly applies that button to the same named group. For more information about IE8 mode, see Defining Document Compatibility.

In Internet Explorer 8 and later versions, you can set the IHTMLDOMAttribute2::name attribute at run time on elements that are dynamically created with the IHTMLDocument2::createElement method. To create an element with a IHTMLDOMAttribute2::name attribute in earlier versions of Windows Internet Explorer, include the attribute and its value when you use the IHTMLDocument2::createElement method.

In Microsoft Internet Explorer 6 and later versions, this property applies to the attribute object.

 

 

Build date: 6/12/2012