PresentationLockingBehavior enumeration

Represents the behavior regarding treating the IPresentation source (file or Stream) while loading and working with an instance of IPresentation. The source is the parameter passed to the IPresentation constructor. In the example below, the source is the “pres.pptx” file:

LoadOptions loadOptions = new LoadOptions { 
  BlobManagementOptions = { PresentationLockingBehavior = PresentationLockingBehavior.KeepLocked } };
using (IPresentation pres = new Presentation("pres.pptx", loadOptions)) { }

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.

public enum PresentationLockingBehavior


Name Value Description
LoadAndRelease 0 The source will be locked only for a time of IPresentation constructor execution. If IsTemporaryFilesAllowed 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 KeepLocked, and if it is possible to pass the ownership of the source to IPresentation, it is recommended to use KeepLocked.
KeepLocked 1 The source will be locked for a whole lifetime of IPresentation instance, until it will be disposed. IsTemporaryFilesAllowed 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 LoadAndRelease.

See Also