putProperty Method
Sets the value of a property. The property name is any qualified Uniform Resource Identifier (URI).
[Visual Basic]
Usage Syntax
oSAXXMLReader.putProperty(strName, varValue)
Parameters
- strName
- The property's name.
- varValue
- The corresponding data type of the property.
Return Values
The following table shows the return values for the putProperty
method.
Property | Returns |
---|---|
charset
schema-declaration-handler |
Sets property |
declaration-handler lexical-handler schemas |
Trappable error (if unable to set property). |
dom-node xmldecl-version xmldecl-standalone |
Trappable error. |
Other properties | Trappable error |
[C/C++]
Although a core set of properties is defined, a reader is not required to recognize any specific property names. Some property values may be available only in a specific context, such as before, during, or after a parse.
Syntax
HRESULT putProperty( [in] const wchar_t * pwchName, [in] VARIANT varValue);
Parameters
- pwchName [in]
- The property's name (zero-terminated Unicode string).
- varValue [in]
- The corresponding data type of the property.
Return Values
The following table lists the return values for the putProperty
method.
Property | Returns |
---|---|
charset schema-declaration-handler |
S_OK (regardless of parsing mode) |
declaration-handler lexical-handler schemas |
S_OK (not parsing)
E_FAIL (parsing) |
dom-node xmldecl-version xmldecl-standalone |
E_FAIL |
Other properties | E_INVALIDARG |
Remarks
The ISAXXMLReader
interface recognizes the following properties:
"http://xml.org/sax/properties/lexical-handler"
This is an optional extension handler for lexical events, like comments.
Datatype — ISAXXMLLexicalHandler.
Access — Read/write.
"http://xml.org/sax/properties/declaration-handler"
This is an optional extension handler for declaration events.
Datatype — ISAXXMLDeclHandler
Access — Read/write.
"charset"
Externally defined encoding to use with an XML document. An example is the one used in the MIME-header. This setting takes priority over the default encoding, which is implicitly UTF-16, or over the encoding specified in the byte order mark (BOM) of the XML document header.
This property only affects documents that are parsed using the parse method. For any documents that are parsed using the parseURL method, this property is ignored. This property can be set at any time, but it only affects documents that are opened after it is set. For example, if it is set in the resolveEntity method (which is available when you implement a SAX entity resolver), it affects the external entity to be opened, but does not affect the main document, which is currently being parsed.
Datatype — BSTR* (The string value must be a recognized description of a character set that is valid for use with XML. For example, "US-ASCII", "UTF-8", etc.)
Default — Empty (uses either the BOM in XML header or the default encoding)
Access — Read/write.
"http://xml.org/sax/properties/dom-node"
Source DOM node for current SAX event. Only available when usingparse
method and SAX events are generated from anIXMLDOMNode
object. Not available when usingparseURL
method for SAX parsing of a file.
Datatype — IXMLDOMNode.
Access — Read-only.
"http://xml.org/sax/properties/xml-string"
The literal string of characters in the XML source for the current SAX event.
Datatype — String (Visual Basic) / w_chart* (C/C++)
Access — Read-only.
"schemas"
An option for registering a schema with the SAX reader.
Datatype — XMLSchemaCache.
Access — (parsing) Read-only; (not parsing) Read/Write.
"schema-declaration-handler"
An option for registering a schema-based declaration handler with the SAX reader.
Datatype — Event handler that implements the IMXSchemaDeclHandler
interface.
Access — Read/write.
"xmldecl-encoding"
Encoding declared in the XML header of the currently parsed document. This data is unavailable until the reader parses the XML header.
Datatype — BSTR.
Default — Empty (if there is no XML declaration or a property is not found).
Access — (parsing) Read; (not parsing) None.
"xmldecl-version"
Version declared in the XML header of currently parsed document. This data is unavailable until the reader parses the XML header.
Datatype — BSTR.
Default — Empty (if there is no XML declaration).
Access — (parsing) Read; (not parsing) None.
"xmldecl-standalone"
Declared in the XML header of currently parsed document. This data is unavailable until the reader parses the XML header.
Datatype — BSTR ("yes" or "no").
Default — Empty (if there is no XML declaration or if a property is not found).
Access — (parsing) Read; (not parsing) None.
Note The"xmldecl-encoding"
,"xmldecl-version"
, and"xmldecl-standalone"
properties provide information about the presence and content of the XML header. However, XML header information was designed for low-level reader and parser use, not for applications.
To view reference information for Visual Basic or C/C++ only, click the Language Filter button in the upper-left corner of the page.
See Also
Applies to: ISAXXMLReader Interface