PresentationLockingBehavior

Inheritance: java.lang.Object, com.aspose.ms.System.ValueType, com.aspose.ms.System.Enum

public final class PresentationLockingBehavior extends System.Enum

Represents the behavior regarding treating the IPresentation source (file or java.io.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);

The source is the parameter passed to the 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.

Fields

Field Description
LoadAndRelease The source will be locked only for a time of IPresentation constructor execution.
KeepLocked The source will be locked for a whole lifetime of IPresentation instance, until it will be disposed.

LoadAndRelease

public static final int LoadAndRelease

The source will be locked only for a time of IPresentation constructor execution.


If (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.


This behavior is slower than PresentationLockingBehavior#KeepLocked, and if it is possible to pass the ownership of the source to IPresentation, it is recommended to use PresentationLockingBehavior#KeepLocked.

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.


This behavior is recommended, it is faster and consumes less memory than PresentationLockingBehavior#LoadAndRelease.