output Property
A version of this page is also available for
4/8/2010
Gets a custom output to write the result of the transformation.
Script Syntax
output = objXSLProcessor.output;
objXSLProcessor.output (output);
Remarks
Script Parameters
- output
The object to which to write the output of the transformation.
Script Return Value
Object. The custom output object or a BSTR containing the transformation result.
C/C++ Syntax
HRESULT get_output(
VARIANT* pOutput
);
HRESULT put_output(
VARIANT output
);
Remarks
C/C++ Parameters
- 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.
C/C++ Return Values
- 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.
Requirements
| Header | msxml2.h, msxml2.idl |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
General 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.