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, toStringpublic 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.