output Property (Compact 2013)

  • Article

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.

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,
msxml2.idl

See Also

Reference

XML DOM Properties