LoadingStreamBehavior

LoadingStreamBehavior enumeration

The stream passed to a method is considered as a Binary Large Object (BLOB) (see
IBlobManagementOptions description). Values of this enumeration identify how
the stream should be treated when it passed to the method. Depending on the
requirements, different decisions could be made to provide the most efficient behavior.

Members

Member name Description
READ_STREAM_AND_RELEASE The stream will be read to the end and then released - i.e. it will be guaranteed that this stream
will not be used by IPresentation instance in the future. It can be closed by the client
code or used in any other way.
KEEP_LOCKED The stream will be locked inside the IPresentation object, i.e. the ownership of
the stream will be transferred. The IPresentation object will be responsible to
correctly dispose the stream when this object will be disposed itself.
This behavior is extremely useful when you need to serialize a large BLOB file (such as a large
video or audio -see IBlobManagementOptions description) and want to prevent loading
this file into memory or other performance issues. You may just open the stream
for this file and pass to a method, choosing KEEP_LOCKED LoadingStreamBehavior.

See Also