Click or drag to resize

PFObjectLock Class

Represents a lock set on a Packflow object by a user.

This lock prevents other users to modify the concerned object at the same time, avoiding conflicts.

Note: this does NOT prevent object modification using the API.

Inheritance Hierarchy

Namespace:  Packflow.Core
Assembly:  MicaSystems.Packflow.Core (in MicaSystems.Packflow.Core.dll) Version: 1.0.0.0 (3.2.0.306)
Syntax
C#
public sealed class PFObjectLock : PFBaseObject, 
	IPFLock

The PFObjectLock type exposes the following members.

Constructors
  NameDescription
Public methodPFObjectLock
Top
Properties
  NameDescription
Public propertyBeforeSaveValues
Gets the previous values of modified fields before the latest Save.

Note: this feature is NOT persisted in the database and therefore only concerns this instance.

(Inherited from PFBaseObject.)
Public propertyCanDelete
Checks if the current permission context allows current user to delete this object.
(Inherited from PFBaseObject.)
Public propertyCanRead
Checks if the current permission context allows current user to access this object.
(Inherited from PFBaseObject.)
Public propertyCanUpdate
Checks if the current permission context allows current user to update this object.
(Inherited from PFBaseObject.)
Public propertyCreated
Indicates if this object has been created and is still in database (positive Id).
(Inherited from PFBaseObject.)
Public propertyCreatedAt
Gets the date of creation of this object in the database.
(Inherited from PFBaseObject.)
Public propertyCreatedBy
Gets the user who created this object in the database.
(Inherited from PFBaseObject.)
Public propertyData
Gets the data collection of this object.
(Inherited from PFBaseObject.)
Public propertyDateObjectCreation
Gets the date of the creation of this object in memory.
(Inherited from PFManagedObject.)
Public propertyDeleted
True if this object is flagged as deleted.
(Inherited from PFBaseObject.)
Public propertyDeletedAt
Date of the suppression of this object.
(Inherited from PFBaseObject.)
Public propertyDeletedBy
The user who deleted this object.
(Inherited from PFBaseObject.)
Public propertyDisplayText
Gets or sets the display text representing the locked object.
Public propertyEnableVersionMergeToResolveSaveConflicts
Gets a value indicating whether versions can be merged to resolve save conflicts. If an object is saved with an older version than the last persisted (in database), the system will try to merge the versions values (if no conflicts between values) and will then save the merged item to database. Note : this setting is NOT persisted and will affect this object instance only.
(Inherited from PFBaseObject.)
Public propertyExists
Indicates if this object has been created, still exists in database and is not flagged for suppression.
(Inherited from PFBaseObject.)
Public propertyExpirationDate
Gets the expiration date. By default, the date is set to the object creation time + DefaultValidity (900 seconds).

You can reset this date using the ResetValidity method.

Public propertyExpired
Gets a value indicating whether the expiration date is passed.
Public propertyGuid
Gets the GUID identifying this object. Must be used if Id is no more viable, example if content were merged.
(Inherited from PFBaseObject.)
Public propertyHasPendingModifications
Checks if there is pending changes. Will check if the values are different from the currently persisted values.
(Inherited from PFBaseObject.)
Public propertyHasPendingPermissionsModifications
Checks if there is pending modifications in permissions. Will compute permissions (RUD) and check if there is differences with current persisted permissions.
(Inherited from PFBaseObject.)
Public propertyId
Gets the id identifying this object. Must be used to find or identify an object because faster than Guid.
(Inherited from PFBaseObject.)
Public propertyKeepBeforeSaveValues
Gets or sets a value indicating whether the Save should keep a collection of the modified fields previous values.

Note: this feature is NOT persisted in the database and therefore only concerns this instance.

(Inherited from PFBaseObject.)
Public propertyLogger
Gets the logger, used to log any useful warning, error or information in the database.
(Inherited from PFManagedObject.)
Public propertyLogIdentification
Gets a technical text representing this object.
(Inherited from PFBaseObject.)
Public propertyObject
Gets the locked object.

If the object has not been previously loaded, it is loaded from the object reference.

Public propertyObjectGuid
Gets the locked object GUID.
Public propertyObjectReference
Gets the locked object reference.
Public propertyObjectType
Gets the type of the locked object.
Public propertyPageUrl
Gets or sets the URL of the form allowing the edition of the locked object.
Public propertyParentDisplayBackColor
Gets or sets the background color of the parent object representation.
Public propertyParentDisplayColor
Gets or sets the text color of the parent object representation.
Public propertyParentDisplayText
Gets or sets a display text representing the parent object of the locked object.
Public propertyPermissionContext
Gets an object calculating permissions on demand.
Public propertyPermissions
Gets the permission set (RUD permissions) of this item.
(Inherited from PFBaseObject.)
Public propertySite
Gets the root of the persisted objects tree.
(Inherited from PFBaseObject.)
Public propertyUnlimitedModification
Gets or sets a value indicating whether the lock also provides unlimited modification to the user.

E.g. in this mode the user can modify all fields, ignoring the current state rules.

Public propertyUpdatedAt
Gets the date of the last update of this object.
(Inherited from PFBaseObject.)
Public propertyUpdatedBy
Gets the user who last updated this object in the database.
(Inherited from PFBaseObject.)
Public propertyUser
Gets the user owning this lock.
Public propertyUserGuid
Gets the GUID of the user owning this lock.
Public propertyUserId
Gets the id of the user owning this lock.
Public propertyVersionNumber
Gets the version number of this object in database. Incremented after each save.
(Inherited from PFBaseObject.)
Top
Methods
  NameDescription
Public methodDelete
Flags this object as deleted.

If it fails, throws an error.

If the object could not be deleted because it does not yet exist in database, returns false.

If successful, returns true.

(Overrides PFBaseObjectDelete.)
Public methodResetValidity
Reset validity from now. Will not save.
Public methodRunInTransactionArea
Runs a code with a transaction on object connection. If there is no current transaction and if the code succeed, transaction is committed. If an exception is thrown, transaction is rollback.
(Inherited from PFBaseObject.)
Public methodSave
Applies the data of this object in the database.
(Overrides PFBaseObjectSave.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Top
Fields
  NameDescription
Public fieldStatic memberDefaultValidity
Time during which the lock stays valid (in seconds).
Public fieldStatic memberFieldName_DisplayText
Column name in database.
Public fieldStatic memberFieldName_ExpirationDate
Column name in database.
Public fieldStatic memberFieldName_ObjectGuid
Column name in database.
Public fieldStatic memberFieldName_ObjectType
Column name in database.
Public fieldStatic memberFieldName_PageUrl
Column name in database.
Public fieldStatic memberFieldName_ParentDisplayBackColor
Column name in database.
Public fieldStatic memberFieldName_ParentDisplayColor
Column name in database.
Public fieldStatic memberFieldName_ParentDisplayText
Column name in database.
Public fieldStatic memberFieldName_SerializedObjectReference
Column name in database.
Public fieldStatic memberFieldName_UnlimitedModification
Column name in database.
Public fieldStatic memberFieldName_UserGuid
Column name in database.
Public fieldStatic memberFieldName_UserId
Column name in database.
Top
Extension Methods
  NameDescription
Public Extension MethodAsT
Casts an object to another type. Returns default(T) if the object is null.
(Defined by Utils_Other.)
Public Extension MethodEqualsAll
Checks that this object is equal to every object in parameters.
(Defined by Utils_Other.)
Public Extension MethodEqualsAny
Checks that this object is equal to at least one of the parameters.
(Defined by Utils_Other.)
Public Extension MethodGetMessage
Gets a translated message representing the object lock.
(Defined by CoreExtensions.)
Public Extension MethodGetString
Converts an object to String using ToString() method, else returns String.Empty.
(Defined by Utils_Other.)
Public Extension MethodIsGenericListOverloaded.
Checks if this object is a System.Collections.Generic.List.
(Defined by Utils_Linq.)
Public Extension MethodIsGenericList(Type)Overloaded.
Checks if this object is a System.Collections.Generic.List using type as T.
(Defined by Utils_Linq.)
Public Extension MethodSerializeOverloaded.
Serializes an object into an XML document.
(Defined by Utils_Xml.)
Public Extension MethodSerialize(String)Overloaded.
Serializes an object into an XML document.
(Defined by Utils_Xml.)
Public Extension MethodSerializeJsonOverloaded.
Serializes an object using a DataContractJsonSerializer.
(Defined by Utils_String.)
Public Extension MethodSerializeJson(ListType)Overloaded.
Serializes an object using a DataContractJsonSerializer.
(Defined by Utils_String.)
Public Extension MethodSerializeJson(DataContractJsonSerializerSettings)Overloaded.
Serializes an object using a DataContractJsonSerializer.
(Defined by Utils_String.)
Top
See Also