public final class PresentationLockingBehavior
extends com.aspose.ms.System.Enum
Represents the behavior regarding treating the IPresentation
source (file or
InputStream
) while loading and working with an instance of IPresentation
.
BlobManagementOptions blobOptions = new BlobManagementOptions(); blobOptions.setPresentationLockingBehavior(PresentationLockingBehavior.KeepLocked); LoadOptions loadOptions = new LoadOptions(); loadOptions.setBlobManagementOptions(blobOptions); IPresentation pres = new Presentation("pres.pptx", loadOptions);
IPresentation
constructor. In the
example below, the source is the "pres.pptx" file:
For this example, the source ("pres.pptx" file) will be locked for a IPresentation
instance lifetime, i.e. can't be changed or deleted by the other process.
Modifier and Type | Field and Description |
---|---|
static int |
KeepLocked
The source will be locked for a whole lifetime of
IPresentation instance, until it will
be disposed. |
static int |
LoadAndRelease
The source will be locked only for a time of
IPresentation constructor execution. |
static int |
LoadAndRelease_Legacy_TemporaryDefault
Deprecated.
Use KeepLocked or LoadAndRelease. The option will be removed in version 17.10. KeepLocked will be the default option after removing this one.
|
Clone, CloneTo, format, format, get_Caption, get_Value, getName, getName, getNames, getNames, getUnderlyingType, getUnderlyingType, getValue, getValues, isDefined, isDefined, isDefined, isDefined, parse, parse, parse, parse, register, toObject, toString
public static final int LoadAndRelease
The source will be locked only for a time of IPresentation
constructor execution.
IBlobManagementOptions.IsTemporaryFilesAllowed
(IBlobManagementOptions.isTemporaryFilesAllowed()
/IBlobManagementOptions.setTemporaryFilesAllowed(boolean)
) is set to false, all BLOBs
will be loaded into memory. Otherwise, other means such a temporary files might be used.KeepLocked
, and if it is possible to pass the
ownership of the source to IPresentation
, it is recommended to use KeepLocked
.
public static final int KeepLocked
The source will be locked for a whole lifetime of IPresentation
instance, until it will
be disposed.
IBlobManagementOptions.IsTemporaryFilesAllowed
(IBlobManagementOptions.isTemporaryFilesAllowed()
/IBlobManagementOptions.setTemporaryFilesAllowed(boolean)
) is must be set to true for using
this behavior, otherwise exception will be thrown.LoadAndRelease
.
@Deprecated public static final int LoadAndRelease_Legacy_TemporaryDefault
The source will be locked only for a time of IPresentation
constructor execution, all BLOBs
will be loaded into memory.
This behavior is the legacy behavior to provide backward compatibility. The same behavior can be achieved
by using LoadAndRelease
and set IBlobManagementOptions.IsTemporaryFilesAllowed
(IBlobManagementOptions.isTemporaryFilesAllowed()
/IBlobManagementOptions.setTemporaryFilesAllowed(boolean)
)
to false.
Please consider choosing the LoadAndRelease
or KeepLocked
behavior, what is
the most suitable for you.
After LoadAndRelease_Legacy_TemporaryDefault
will be removed, KeepLocked
will be the default behavior.