See Also
 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
Sets the value of the named attribute.
Script Syntax
 Copy Code
|
|
|---|---|
oXMLDOMElement.setAttribute( name, value); |
|
Remarks
Script Parameters
- name
-
String specifying the name of the attribute. If the attribute with that name already exists, its value is changed. If the attribute with that name does not exist, it is created.
- value
-
Variant that supplies the value for the named attribute.
Script Return Value
None.
C/C++ Syntax
|
Copy Code
|
|
|---|---|
HRESULT setAttribute( BSTR name, VARIANT value ); |
|
Remarks
C/C++ Parameters
- name
-
[in] Name of the attribute. If an attribute with that name already exists, its value is changed. If an attribute with that name does not exist, it is created.
- value
-
[in] Value for the named attribute.
C/C++ Return Values
- S_OK
-
Value returned if successful.
- E_FAIL
-
Value returned if an error occurs.
Requirements
| Header | msxml2.h, msxml2.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
General Remarks
If an attribute with the supplied name already exists, this method changes its value to the supplied valueparameter. The supplied string is not parsed, so any markup, such as syntax meant to be recognized as an entity reference, is treated as literal text and must be appropriately escaped by the implementation when it is written out.
To assign an attribute value that contains entity references, the user must create IXMLDOMAttributeplus any IXMLDOMTextand IXMLDOMEntityReferenceobjects, build the appropriate subtree, and call the setAttributeNode Method.
This method applies to the following objects and interfaces:
IXMLDOMAttribute, IXMLDOMElement, IXMLDOMText, and IXMLDOMEntityReference.