Defines the common properties required objects that track their own status. More...

Inheritance diagram for Csla.Core.ITrackStatus:

Properties
bool	IsValid `[get]`
	Returns true if the object and its child objects are currently valid, false if the object or any of its child objects have broken rules or are otherwise invalid. More...

bool	IsSelfValid `[get]`
	Returns true if the object is currently valid, false if the object has broken rules or is otherwise invalid. More...

bool	IsDirty `[get]`
	Returns true if this object's data, or any of its fields or child objects data, has been changed. More...

bool	IsSelfDirty `[get]`
	Returns true if this object's data has been changed. More...

bool	IsDeleted `[get]`
	Returns true if this object is marked for deletion. More...

bool	IsNew `[get]`
	Returns true if this is a new object, false if it is a pre-existing object. More...

bool	IsSavable `[get]`
	Returns true if this object is both dirty and valid. More...

bool	IsChild `[get]`
	Returns true if this is a child object, false if it is a root object. More...

Properties inherited from Csla.Core.INotifyBusy
bool	IsBusy `[get]`
	Gets a value indicating whether the object, or any of the object's child objects, are busy running an asynchronous operation. More...

bool	IsSelfBusy `[get]`
	Gets a value indicating whether the object is busy running an asynchronous operation. More...

Additional Inherited Members
Events inherited from Csla.Core.INotifyBusy
BusyChangedEventHandler	BusyChanged
	Event raised when the object's busy status changes. More...

Events inherited from Csla.Core.INotifyUnhandledAsyncException
EventHandler< ErrorEventArgs >	UnhandledAsyncException
	Event indicating that an exception occurred during an asynchronous operation. More...

Detailed Description

Defines the common properties required objects that track their own status.

Definition at line 16 of file ITrackStatus.cs.

Property Documentation

◆ IsChild

bool Csla.Core.ITrackStatus.IsChild

get

Returns true if this is a child object, false if it is a root object.

An object should be marked as a child object unless it is the top most object (root object) in a business object graph.

Returns: A value indicating if this a child object.

Definition at line 142 of file ITrackStatus.cs.

◆ IsDeleted

bool Csla.Core.ITrackStatus.IsDeleted

get

Returns true if this object is marked for deletion.

CSLA .NET supports both immediate and deferred deletion of objects. This property is part of the support for deferred deletion, where an object can be marked for deletion, but isn't actually deleted until the object is saved to the database. This property indicates whether or not the current object has been marked for deletion. If it is true , the object will be deleted when it is saved to the database, otherwise it will be inserted or updated by the save operation.

Returns: A value indicating if this object is marked for deletion.

Definition at line 106 of file ITrackStatus.cs.

◆ IsDirty

bool Csla.Core.ITrackStatus.IsDirty

get

Returns true if this object's data, or any of its fields or child objects data, has been changed.

When an object's data is changed, CSLA .NET makes note of that change and considers the object to be 'dirty' or changed. This value is used to optimize data updates, since an unchanged object does not need to be updated into the database. All new objects are considered dirty. All objects marked for deletion are considered dirty.

Once an object's data has been saved to the database (inserted or updated) the dirty flag is cleared and the object is considered unchanged. Objects newly loaded from the database are also considered unchanged.

Returns: A value indicating if this object's data has been changed.

Definition at line 73 of file ITrackStatus.cs.

◆ IsNew

bool Csla.Core.ITrackStatus.IsNew

get

Returns true if this is a new object, false if it is a pre-existing object.

An object is considered to be new if its primary identifying (key) value doesn't correspond to data in the database. In other words, if the data values in this particular object have not yet been saved to the database the object is considered to be new. Likewise, if the object's data has been deleted from the database then the object is considered to be new.

Returns: A value indicating if this object is new.

Definition at line 120 of file ITrackStatus.cs.

◆ IsSavable

bool Csla.Core.ITrackStatus.IsSavable

get

Returns true if this object is both dirty and valid.

An object is considered dirty (changed) if P:Csla.BusinessBase.IsDirty returns true. It is considered valid if IsValid returns true. The IsSavable property is a combination of these two properties.

Returns: A value indicating if this object is both dirty and valid.

Definition at line 132 of file ITrackStatus.cs.

◆ IsSelfDirty

bool Csla.Core.ITrackStatus.IsSelfDirty

get

Returns true if this object's data has been changed.

When an object's data is changed, CSLA .NET makes note of that change and considers the object to be 'dirty' or changed. This value is used to optimize data updates, since an unchanged object does not need to be updated into the database. All new objects are considered dirty. All objects marked for deletion are considered dirty.

Once an object's data has been saved to the database (inserted or updated) the dirty flag is cleared and the object is considered unchanged. Objects newly loaded from the database are also considered unchanged.

Returns: A value indicating if this object's data has been changed.

Definition at line 91 of file ITrackStatus.cs.

◆ IsSelfValid

bool Csla.Core.ITrackStatus.IsSelfValid

get

Returns true if the object is currently valid, false if the object has broken rules or is otherwise invalid.

By default this property relies on the underling ValidationRules object to track whether any business rules are currently broken for this object.

You can override this property to provide more sophisticated implementations of the behavior.

Returns: A value indicating if the object is currently valid.

Definition at line 53 of file ITrackStatus.cs.

◆ IsValid

bool Csla.Core.ITrackStatus.IsValid

get

Returns true if the object and its child objects are currently valid, false if the object or any of its child objects have broken rules or are otherwise invalid.