output Property (Compact 2013)
3/26/2014
Gets a custom output to write the result of the transformation.
Syntax
output = objXSLProcessor.output;
objXSLProcessor.output (output);
HRESULT get_output( VARIANT* pOutput);
HRESULT put_output( VARIANT output);
Parameters
Script
- output
The object to which to write the output of the transformation.
C/C++
- pOutput
[out, retval] The custom output object or a BSTR containing the transformation result.
- output
[in] The object to write the output of the transformation to.
Return Value
Script
Object. The custom output object or a BSTR containing the transformation result.
C/C++
- E_NOINTERFACE
Value returned if the given output object does not support a supported interface.
- E_FAIL
Value returned if readyState Property (DOMDocument) is READYSTATE_INTERACTIVE.
Remarks
The output property can be any object/interface that supports IStream, IPersistStream, DOMDocument, ASP IResponse, or ADODB.Stream.
When a new transform is started, the processor will use a QueryInterface this output for IStream. When the transform is complete or reset is called, IStream is released. The only method that is used on IStream is Write. The bytes written to the stream will be encoded according to the encoding attribute on the <xsl:output> element.
If you do not provide a custom output, then you will get a string when you read this property. The string contains the incrementally buffered transformation result.
Reading this property has the side effect of resetting that internal buffer so that each time you read the property you get the next chunk of output. In this case, the output is always generated in the Unicode encoding, and the encoding attribute on the <xsl:output> element is ignored.
Requirements
Header |
msxml2.h, |