This is the non-generic base class from which most business objects will be derived. More...

Inheritance diagram for Csla.Core.BusinessBase:

Classes
class	BypassPropertyChecksObject
	Class that allows setting of property values on current business object without raising PropertyChanged events and checking user rights.

Public Member Functions
virtual bool	CanReadProperty (Csla.Core.IPropertyInfo property)
	Returns true if the user is allowed to read the calling property. More...

bool	CanReadProperty (Csla.Core.IPropertyInfo property, bool throwOnFalse)
	Returns true if the user is allowed to read the calling property. More...

bool	CanReadProperty (string propertyName)
	Returns true if the user is allowed to read the specified property. More...

virtual bool	CanWriteProperty (Csla.Core.IPropertyInfo property)
	Returns true if the user is allowed to write the specified property. More...

bool	CanWriteProperty (Csla.Core.IPropertyInfo property, bool throwOnFalse)
	Returns true if the user is allowed to write the calling property. More...

bool	CanWriteProperty (string propertyName)
	Returns true if the user is allowed to write the specified property. More...

virtual bool	CanExecuteMethod (Csla.Core.IMemberInfo method)
	Returns true if the user is allowed to execute the specified method. More...

bool	CanExecuteMethod (Csla.Core.IMemberInfo method, bool throwOnFalse)
	Returns true if the user is allowed to execute the specified method. More...

virtual bool	CanExecuteMethod (string methodName)
	Returns true if the user is allowed to execute the specified method. More...

void	BeginEdit ()
	Starts a nested edit on the object. More...

void	CancelEdit ()
	Cancels the current edit process, restoring the object's state to its previous values. More...

void	ApplyEdit ()
	Commits the current edit process. More...

virtual void	Delete ()
	Marks the object for deletion. More...

virtual bool	IsPropertyBusy (Csla.Core.IPropertyInfo property)
	Gets a value indicating whether a specific property is busy (has a currently executing async rule). More...

bool	IsPropertyBusy (string propertyName)
	Gets a value indicating whether a specific property is busy (has a currently executing async rule). More...

BrokenRulesCollection	GetBrokenRules ()
	Gets the broken rules for this object More...

Public Member Functions inherited from Csla.Security.IAuthorizeReadWrite
bool	CanWriteProperty (Csla.Core.IPropertyInfo property)
	Returns true if the user is allowed to write the to the specified property. More...

bool	CanReadProperty (Csla.Core.IPropertyInfo property)
	Returns true if the user is allowed to read the specified property. More...

bool	CanExecuteMethod (Csla.Core.IMemberInfo method)
	Returns true if the user is allowed to execute the specified method. More...

Public Member Functions inherited from Csla.Core.IParent
void	RemoveChild (Core.IEditableBusinessObject child)
	This method is called by a child object when it wants to be removed from the collection. More...

Protected Member Functions
	BusinessBase ()
	Creates an instance of the type. More...

override void	OnApplicationContextSet ()
	Method invoked after ApplicationContext is available. More...

virtual void	Initialize ()
	Override this method to set up event handlers so user code in a partial class can respond to events raised by generated code. More...

virtual void	SetParent (Core.IParent parent)
	Used by BusinessListBase as a child object is created to tell the child object about its parent. More...

virtual void	MarkNew ()
	Marks the object as being a new object. More...

virtual void	MarkOld ()
	Marks the object as being an old (not new) object. More...

void	MarkDeleted ()
	Marks an object for deletion. More...

void	MarkDirty ()
	Marks an object as being dirty, or changed. More...

void	MarkDirty (bool suppressEvent)
	Marks an object as being dirty, or changed. More...

virtual void	PropertyHasChanged (Csla.Core.IPropertyInfo property)
	Performs processing required when a property has changed. More...

virtual void	MetaPropertyHasChanged (string name)
	Raises OnPropertyChanged for meta properties (IsXYZ) when PropertyChangedMode is not Windows More...

virtual void	CheckPropertyRules (IPropertyInfo property)
	Check rules for the property and notifies UI of properties that may have changed. More...

virtual void	CheckObjectRules ()
	Check object rules and notifies UI of properties that may have changed. More...

void	MarkClean ()
	Forces the object's IsDirty flag to false. More...

override void	UndoChangesComplete ()
	Called when an undo operation has completed. More...

override void	AcceptChangesComplete ()
	Notifies the parent object (if any) that this child object's edits have been accepted. More...

void	MarkAsChild ()
	Marks the object as being a child object. More...

virtual object	GetClone ()
	Creates a clone of the object. More...

virtual void	OnValidationComplete ()
	Raises the ValidationComplete event More...

BusinessRuleManager	GetRegisteredRules ()
	Gets the registered rules. More...

virtual void	AddBusinessRules ()
	Override this method in your business class to be notified when you need to set up shared business rules. More...

virtual void	DataPortal_OnDataPortalInvoke (DataPortalEventArgs e)
	Called by the server-side DataPortal prior to calling the requested DataPortal_XYZ method. More...

virtual void	DataPortal_OnDataPortalInvokeComplete (DataPortalEventArgs e)
	Called by the server-side DataPortal after calling the requested DataPortal_XYZ method. More...

virtual void	DataPortal_OnDataPortalException (DataPortalEventArgs e, Exception ex)
	Called by the server-side DataPortal if an exception occurs during data access. More...

virtual void	Child_Create ()
	Override this method to load a new business object with default values from the database. More...

virtual void	Child_OnDataPortalInvoke (DataPortalEventArgs e)
	Called by the server-side DataPortal prior to calling the requested DataPortal_XYZ method. More...

virtual void	Child_OnDataPortalInvokeComplete (DataPortalEventArgs e)
	Called by the server-side DataPortal after calling the requested DataPortal_XYZ method. More...

virtual void	Child_OnDataPortalException (DataPortalEventArgs e, Exception ex)
	Called by the server-side DataPortal if an exception occurs during data access. More...

virtual void	OnErrorsChanged (string propertyName)
	Call to indicate that errors have changed for a property. More...

override void	OnPropertyChanged (IPropertyInfo propertyInfo)
	Call this method to raise the PropertyChanged event for a specific property. More...

virtual void	OnDeserialized (System.Runtime.Serialization.StreamingContext context)
	This method is called on a newly deserialized object after deserialization is complete. More...

void	AddEventHooks (IBusinessObject child)
	For internal use. More...

virtual void	OnAddEventHooks (IBusinessObject child)
	Hook child object events. More...

void	RemoveEventHooks (IBusinessObject child)
	For internal use only. More...

virtual void	OnRemoveEventHooks (IBusinessObject child)
	Unhook child object events. More...

P	GetProperty< P > (string propertyName, P field, P defaultValue)
	Gets a property's value, first checking authorization. More...

P	GetProperty< P > (string propertyName, P field, P defaultValue, Security.NoAccessBehavior noAccess)
	Gets a property's value, first checking authorization. More...

P	GetProperty< P > (PropertyInfo< P > propertyInfo, P field)
	Gets a property's value, first checking authorization. More...

P	GetProperty< P > (PropertyInfo< P > propertyInfo, P field, P defaultValue, Security.NoAccessBehavior noAccess)
	Gets a property's value, first checking authorization. More...

P	GetPropertyConvert< F, P > (PropertyInfo< F > propertyInfo, F field)
	Gets a property's value as a specified type, first checking authorization. More...

P	GetPropertyConvert< F, P > (PropertyInfo< F > propertyInfo, F field, Security.NoAccessBehavior noAccess)
	Gets a property's value as a specified type, first checking authorization. More...

P	GetProperty< P > (PropertyInfo< P > propertyInfo)
	Gets a property's managed field value, first checking authorization. More...

P	GetPropertyConvert< F, P > (PropertyInfo< F > propertyInfo)
	Gets a property's value from the list of managed field values, first checking authorization, and converting the value to an appropriate type. More...

P	GetPropertyConvert< F, P > (PropertyInfo< F > propertyInfo, Security.NoAccessBehavior noAccess)
	Gets a property's value from the list of managed field values, first checking authorization, and converting the value to an appropriate type. More...

P	GetProperty< P > (PropertyInfo< P > propertyInfo, Security.NoAccessBehavior noAccess)
	Gets a property's value as a specified type, first checking authorization. More...

object	GetProperty (IPropertyInfo propertyInfo)
	Gets a property's value as a specified type. More...

P	GetProperty< P > (IPropertyInfo propertyInfo)
	Gets a property's managed field value, first checking authorization. More...

P	LazyGetProperty< P > (PropertyInfo< P > property, Func< P > valueGenerator)
	Lazily initializes a property and returns the resulting value. More...

bool	PropertyIsLoading (IPropertyInfo propertyInfo)
	Gets a value indicating whether a lazy loaded property is currently being retrieved. More...

P	LazyGetPropertyAsync< P > (PropertyInfo< P > property, Task< P > factory)
	Lazily initializes a property and returns the resulting value. More...

P	ReadPropertyConvert< F, P > (PropertyInfo< F > propertyInfo)
	Gets a property's value from the list of managed field values, converting the value to an appropriate type. More...

P	ReadProperty< P > (PropertyInfo< P > propertyInfo)
	Gets a property's value as a specified type. More...

virtual object	ReadProperty (IPropertyInfo propertyInfo)
	Gets a property's value. More...

P	LazyReadProperty< P > (PropertyInfo< P > property, Func< P > valueGenerator)
	Gets a property's value as a specified type. More...

P	LazyReadPropertyAsync< P > (PropertyInfo< P > property, Task< P > factory)
	Gets a property's value as a specified type. More...

void	SetProperty< P > (PropertyInfo< P > propertyInfo, ref P field, P newValue)
	Sets a property's backing field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change. More...

void	SetProperty< P > (string propertyName, ref P field, P newValue)
	Sets a property's backing field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change. More...

void	SetPropertyConvert< P, V > (PropertyInfo< P > propertyInfo, ref P field, V newValue)
	Sets a property's backing field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change. More...

void	SetPropertyConvert< P, V > (PropertyInfo< P > propertyInfo, ref P field, V newValue, Security.NoAccessBehavior noAccess)
	Sets a property's backing field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change. More...

void	SetProperty< P > (string propertyName, ref P field, P newValue, Security.NoAccessBehavior noAccess)
	Sets a property's backing field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change. More...

void	SetPropertyConvert< P, V > (string propertyName, ref P field, V newValue, Security.NoAccessBehavior noAccess)
	Sets a property's backing field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change. More...

void	SetProperty< P > (PropertyInfo< P > propertyInfo, P newValue)
	Sets a property's managed field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change. More...

void	SetPropertyConvert< P, F > (PropertyInfo< P > propertyInfo, F newValue)
	Sets a property's managed field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change. More...

void	SetPropertyConvert< P, F > (PropertyInfo< P > propertyInfo, F newValue, Security.NoAccessBehavior noAccess)
	Sets a property's managed field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change. More...

void	SetProperty< P > (PropertyInfo< P > propertyInfo, P newValue, Security.NoAccessBehavior noAccess)
	Sets a property's managed field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change. More...

void	SetProperty (IPropertyInfo propertyInfo, object newValue)
	Sets a property's managed field with the supplied value, and then calls PropertyHasChanged if the value does change. More...

void	SetProperty< P > (IPropertyInfo propertyInfo, P newValue)
	Sets a property's managed field with the supplied value, and then calls PropertyHasChanged if the value does change. More...

void	LoadPropertyConvert< P, F > (PropertyInfo< P > propertyInfo, F newValue)
	Loads a property's managed field with the supplied value. More...

void	LoadProperty< P > (PropertyInfo< P > propertyInfo, P newValue)
	Loads a property's managed field with the supplied value. More...

bool	LoadPropertyMarkDirty< P > (PropertyInfo< P > propertyInfo, P newValue)
	Loads a property's managed field with the supplied value and mark field as dirty if value is modified. More...

virtual bool	LoadPropertyMarkDirty (IPropertyInfo propertyInfo, object newValue)
	Loads a property's managed field with the supplied value. More...

virtual void	LoadProperty (IPropertyInfo propertyInfo, object newValue)
	Loads a property's managed field with the supplied value. More...

void	LoadPropertyAsync< R > (PropertyInfo< R > property, Task< R > factory)
	Load a property from an async method. More...

void	MarkBusy ()
	Mark the object as busy (it is running an async operation). More...

void	MarkIdle ()
	Mark the object as not busy (it is not running an async operation). More...

virtual void	OnBusyChanged (BusyChangedEventArgs args)
	Raise the BusyChanged event. More...

virtual void	OnUnhandledAsyncException (ErrorEventArgs error)
	Raises the UnhandledAsyncException event. More...

void	OnUnhandledAsyncException (object originalSender, Exception error)
	Raises the UnhandledAsyncException event. More...

virtual void	OnChildChanged (ChildChangedEventArgs e)
	Raises the ChildChanged event, indicating that a child object has been changed. More...

virtual void	EditChildComplete (Core.IEditableBusinessObject child)
	Override this method to be notified when a child object's Core.BusinessBase.ApplyEdit method has completed. More...

override void	OnGetState (Csla.Serialization.Mobile.SerializationInfo info, StateMode mode)
	Override this method to insert your field values into the MobileFormatter serialzation stream. More...

override void	OnSetState (Csla.Serialization.Mobile.SerializationInfo info, StateMode mode)
	Override this method to retrieve your field values from the MobileFormatter serialzation stream. More...

override void	OnGetChildren (Csla.Serialization.Mobile.SerializationInfo info, Csla.Serialization.Mobile.MobileFormatter formatter)
	Override this method to insert your child object references into the MobileFormatter serialzation stream. More...

override void	OnSetChildren (Csla.Serialization.Mobile.SerializationInfo info, Csla.Serialization.Mobile.MobileFormatter formatter)
	Override this method to retrieve your child object references from the MobileFormatter serialzation stream. More...

Protected Member Functions inherited from Csla.Core.UndoableBase
	UndoableBase ()
	Creates an instance of the type. More...

virtual void	CopyingState ()
	This method is invoked before the CopyState operation begins. More...

virtual void	CopyStateComplete ()
	This method is invoked after the CopyState operation is complete. More...

virtual void	UndoingChanges ()
	This method is invoked after the UndoChanges operation is complete. More...

virtual void	AcceptingChanges ()
	This method is invoked before the AcceptChanges operation begins. More...

override void	OnGetState (SerializationInfo info, StateMode mode)
	Override this method to insert your field values into the MobileFormatter serialzation stream. More...

override void	OnSetState (SerializationInfo info, StateMode mode)
	Override this method to retrieve your field values from the MobileFormatter serialzation stream. More...

Protected Member Functions inherited from Csla.Core.BindableBase
	BindableBase ()
	Creates an instance of the type. More...

virtual bool	ShouldHandlerSerialize (PropertyChangedEventHandler value)
	Override this method to change the default logic for determining if the event handler should be serialized More...

virtual void	OnPropertyChanged (string propertyName)
	Call this method to raise the PropertyChanged event for a specific property. More...

virtual void	OnMetaPropertyChanged (string propertyName)

virtual void	OnIsDirtyChanged ()
	Call this method to raise the PropertyChanged event for all object properties. More...

virtual void	OnUnknownPropertyChanged ()
	Call this method to raise the PropertyChanged event for all object properties. More...

virtual void	OnIsDirtyChanging ()
	Call this method to raise the PropertyChanging event for all object properties. More...

virtual void	OnUnknownPropertyChanging ()
	Call this method to raise the PropertyChanging event for all object properties. More...

virtual void	OnPropertyChanging (string propertyName)
	Call this method to raise the PropertyChanging event for a specific property. More...

virtual void	OnPropertyChanging (IPropertyInfo propertyInfo)
	Call this method to raise the PropertyChanging event for a specific property. More...

virtual bool	ShouldHandlerSerialize (PropertyChangingEventHandler value)
	Override this method to change the default logic for determining if the event handler should be serialized More...

Protected Member Functions inherited from Csla.Core.MobileObject
virtual void	OnGetChildren (SerializationInfo info, MobileFormatter formatter)
	Override this method to insert your child object references into the MobileFormatter serialzation stream. More...

virtual void	OnSetChildren (SerializationInfo info, MobileFormatter formatter)
	Override this method to retrieve your child object references from the MobileFormatter serialzation stream. More...

Static Protected Member Functions
static Csla.Core.IMemberInfo	RegisterMethod (Type objectType, IMemberInfo info)
	Indicates that the specified method belongs to the type. More...

static MethodInfo	RegisterMethod (Type objectType, string methodName)
	Indicates that the specified method belongs to the type. More...

static PropertyInfo< P >	RegisterProperty< P > (Type objectType, PropertyInfo< P > info)
	Indicates that the specified property belongs to the type. More...

Properties
Core.IParent	Parent `[get]`
	Provide access to the parent reference for use in child object code. More...

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

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

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

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

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

bool	DisableIEditableObject `[getset]`
	Gets or sets a value indicating whether the IEditableObject interface methods should be disabled for this object. More...

bool	IsChild `[get]`
	Returns true if this is a child (non-root) object. More...

EventHandler	ValidationComplete
	Event raised when validation is complete. More...

BusinessRules	BusinessRules `[get]`
	Provides access to the broken rules functionality. More...

virtual 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...

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

virtual Rules.BrokenRulesCollection	BrokenRulesCollection `[get]`
	Provides access to the readonly collection of broken business rules for this object. More...

virtual bool	IsBusy `[get]`
	Gets a value indicating if this object or its child objects are busy. More...

virtual bool	IsSelfBusy `[get]`
	Gets a value indicating if this object is busy. More...

BusyChangedEventHandler	BusyChanged
	Event indicating that the IsBusy property has changed. More...

EventHandler< ErrorEventArgs >	UnhandledAsyncException
	Event indicating that an exception occurred during the processing of an async operation. More...

EventHandler< Csla.Core.ChildChangedEventArgs >	ChildChanged
	Event raised when a child object has been changed. More...

FieldDataManager	FieldManager `[get]`
	Gets the PropertyManager object for this business object. More...

Properties inherited from Csla.Core.UndoableBase
ApplicationContext	ApplicationContext `[getset]`
	Gets or sets a reference to the current ApplicationContext. More...

bool	BindingEdit `[getset]`
	Gets or sets a value indicating whether n-level undo was invoked through IEditableObject. More...

int	EditLevel `[get]`
	Returns the current edit level of the object. More...

Properties inherited from Csla.Core.BindableBase
PropertyChangedEventHandler	PropertyChanged
	Implements a serialization-safe PropertyChanged event. More...

PropertyChangingEventHandler	PropertyChanging
	Implements a serialization-safe PropertyChanging event. More...

Properties inherited from Csla.Core.IUndoableObject
int	EditLevel `[get]`
	Gets the current edit level of the object. More...

Properties inherited from Csla.Core.IUseApplicationContext
ApplicationContext	ApplicationContext `[getset]`
	Gets or sets the current ApplicationContext object. More...

Properties inherited from Csla.Core.IEditableBusinessObject
int	EditLevelAdded `[getset]`
	For internal use only!! More...

Properties inherited from Csla.Core.IBusinessObject
int	Identity `[get]`
	Gets a value representing this object instance's unique identity value within the business object graph. More...

Properties inherited from Csla.Core.ITrackStatus
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...

Properties inherited from Csla.Core.IParent
IParent	Parent `[get]`
	Provide access to the parent reference for use in child object code. 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...

Events inherited from Csla.Core.INotifyChildChanged
EventHandler< ChildChangedEventArgs >	ChildChanged
	Event indictating that a child object has changed. More...

Detailed Description

This is the non-generic base class from which most business objects will be derived.

Definition at line 41 of file Core/BusinessBase.cs.

Constructor & Destructor Documentation

◆ BusinessBase()

Csla.Core.BusinessBase.BusinessBase ( )

protected

Creates an instance of the type.

Definition at line 63 of file Core/BusinessBase.cs.

Member Function Documentation

◆ AcceptChangesComplete()

override void Csla.Core.BusinessBase.AcceptChangesComplete ( )

protectedvirtual

Notifies the parent object (if any) that this child object's edits have been accepted.

Reimplemented from Csla.Core.UndoableBase.

Definition at line 919 of file Core/BusinessBase.cs.

◆ AddBusinessRules()

virtual void Csla.Core.BusinessBase.AddBusinessRules ( )

protectedvirtual

Override this method in your business class to be notified when you need to set up shared business rules.

This method is automatically called by CSLA .NET when your object should associate per-type validation rules with its properties.

Definition at line 1178 of file Core/BusinessBase.cs.

◆ AddEventHooks()

void Csla.Core.BusinessBase.AddEventHooks ( IBusinessObject child )

protected

For internal use.

Parameters

child Child object.

Definition at line 1443 of file Core/BusinessBase.cs.

◆ ApplyEdit()

void Csla.Core.BusinessBase.ApplyEdit ( )

Commits the current edit process.

Calling this method causes the most recently taken snapshot of the object's state to be discarded, thus committing any changes made to the object's state since the last BeginEdit call.

Implements Csla.Core.ISupportUndo.

Definition at line 907 of file Core/BusinessBase.cs.

◆ BeginEdit()

void Csla.Core.BusinessBase.BeginEdit ( )

Starts a nested edit on the object.

When this method is called the object takes a snapshot of its current state (the values of its variables). This snapshot can be restored by calling CancelEdit or committed by calling ApplyEdit.

This is a nested operation. Each call to BeginEdit adds a new snapshot of the object's state to a stack. You should ensure that for each call to BeginEdit there is a corresponding call to either CancelEdit or ApplyEdit to remove that snapshot from the stack.

See Chapters 2 and 3 for details on n-level undo and state stacking.

Implements Csla.Core.ISupportUndo.

Definition at line 864 of file Core/BusinessBase.cs.

◆ CancelEdit()

void Csla.Core.BusinessBase.CancelEdit ( )

Cancels the current edit process, restoring the object's state to its previous values.

Calling this method causes the most recently taken snapshot of the object's state to be restored. This resets the object's values to the point of the last BeginEdit call.

Implements Csla.Core.ISupportUndo.

Definition at line 878 of file Core/BusinessBase.cs.

◆ CanExecuteMethod() [1/3]

virtual bool Csla.Core.BusinessBase.CanExecuteMethod ( Csla.Core.IMemberInfo method )

virtual

Returns true if the user is allowed to execute the specified method.

Parameters

method Method to execute.

Returns: true if execute is allowed.

Definition at line 675 of file Core/BusinessBase.cs.

◆ CanExecuteMethod() [2/3]

bool Csla.Core.BusinessBase.CanExecuteMethod	(	Csla.Core.IMemberInfo	method,
		bool	throwOnFalse
	)

Returns true if the user is allowed to execute the specified method.

Returns: true if execute is allowed.

Parameters

method	Method to execute.
throwOnFalse	Indicates whether a negative result should cause an exception.

Definition at line 702 of file Core/BusinessBase.cs.

◆ CanExecuteMethod() [3/3]

virtual bool Csla.Core.BusinessBase.CanExecuteMethod ( string methodName )

virtual

Returns true if the user is allowed to execute the specified method.

Parameters

methodName Name of the method to execute.

Returns: true if execute is allowed.

Implements Csla.Security.IAuthorizeReadWrite.

Definition at line 724 of file Core/BusinessBase.cs.

◆ CanReadProperty() [1/3]

virtual bool Csla.Core.BusinessBase.CanReadProperty ( Csla.Core.IPropertyInfo property )

virtual

Returns true if the user is allowed to read the calling property.

Parameters

property Property to check.

Definition at line 507 of file Core/BusinessBase.cs.

◆ CanReadProperty() [2/3]

bool Csla.Core.BusinessBase.CanReadProperty	(	Csla.Core.IPropertyInfo	property,
		bool	throwOnFalse
	)

Returns true if the user is allowed to read the calling property.

Returns: true if read is allowed.

Parameters

property	Property to read.
throwOnFalse	Indicates whether a negative result should cause an exception.

Definition at line 534 of file Core/BusinessBase.cs.

◆ CanReadProperty() [3/3]

bool Csla.Core.BusinessBase.CanReadProperty ( string propertyName )

Returns true if the user is allowed to read the specified property.

Parameters

propertyName Name of the property to read.

Implements Csla.Security.IAuthorizeReadWrite.

Definition at line 553 of file Core/BusinessBase.cs.

◆ CanWriteProperty() [1/3]

virtual bool Csla.Core.BusinessBase.CanWriteProperty ( Csla.Core.IPropertyInfo property )

virtual

Returns true if the user is allowed to write the specified property.

Parameters

property Property to write.

Definition at line 582 of file Core/BusinessBase.cs.

◆ CanWriteProperty() [2/3]

bool Csla.Core.BusinessBase.CanWriteProperty	(	Csla.Core.IPropertyInfo	property,
		bool	throwOnFalse
	)

Returns true if the user is allowed to write the calling property.

Returns: true if write is allowed.

Parameters

property	Property to write.
throwOnFalse	Indicates whether a negative result should cause an exception.

Definition at line 609 of file Core/BusinessBase.cs.

◆ CanWriteProperty() [3/3]

bool Csla.Core.BusinessBase.CanWriteProperty ( string propertyName )

Returns true if the user is allowed to write the specified property.

Parameters

propertyName Name of the property to write.

Implements Csla.Security.IAuthorizeReadWrite.

Definition at line 627 of file Core/BusinessBase.cs.

◆ CheckObjectRules()

virtual void Csla.Core.BusinessBase.CheckObjectRules ( )

protectedvirtual

Check object rules and notifies UI of properties that may have changed.

Definition at line 422 of file Core/BusinessBase.cs.

◆ CheckPropertyRules()

virtual void Csla.Core.BusinessBase.CheckPropertyRules ( IPropertyInfo property )

protectedvirtual

Check rules for the property and notifies UI of properties that may have changed.

Parameters

property The property.

Definition at line 409 of file Core/BusinessBase.cs.

◆ Child_Create()

virtual void Csla.Core.BusinessBase.Child_Create ( )

protectedvirtual

Override this method to load a new business object with default values from the database.

Normally you will overload this method to accept a strongly-typed criteria parameter, rather than overriding the method with a loosely-typed criteria parameter.

Definition at line 1288 of file Core/BusinessBase.cs.

◆ Child_OnDataPortalException()

virtual void Csla.Core.BusinessBase.Child_OnDataPortalException	(	DataPortalEventArgs	e,
		Exception	ex
	)

protectedvirtual

Called by the server-side DataPortal if an exception occurs during data access.

Parameters

e	The DataPortalContext object passed to the DataPortal.
ex	The Exception thrown during data access.

Definition at line 1318 of file Core/BusinessBase.cs.

◆ Child_OnDataPortalInvoke()

virtual void Csla.Core.BusinessBase.Child_OnDataPortalInvoke ( DataPortalEventArgs e )

protectedvirtual

Called by the server-side DataPortal prior to calling the requested DataPortal_XYZ method.

Parameters

e	The DataPortalContext object passed to the DataPortal.

Definition at line 1299 of file Core/BusinessBase.cs.

◆ Child_OnDataPortalInvokeComplete()

virtual void Csla.Core.BusinessBase.Child_OnDataPortalInvokeComplete ( DataPortalEventArgs e )

protectedvirtual

Called by the server-side DataPortal after calling the requested DataPortal_XYZ method.

Parameters

e	The DataPortalContext object passed to the DataPortal.

Definition at line 1308 of file Core/BusinessBase.cs.

◆ DataPortal_OnDataPortalException()

virtual void Csla.Core.BusinessBase.DataPortal_OnDataPortalException	(	DataPortalEventArgs	e,
		Exception	ex
	)

protectedvirtual

Called by the server-side DataPortal if an exception occurs during data access.

Parameters

e	The DataPortalContext object passed to the DataPortal.
ex	The Exception thrown during data access.

Definition at line 1276 of file Core/BusinessBase.cs.

◆ DataPortal_OnDataPortalInvoke()

virtual void Csla.Core.BusinessBase.DataPortal_OnDataPortalInvoke ( DataPortalEventArgs e )

protectedvirtual

Called by the server-side DataPortal prior to calling the requested DataPortal_XYZ method.

Parameters

e	The DataPortalContext object passed to the DataPortal.

Definition at line 1257 of file Core/BusinessBase.cs.

◆ DataPortal_OnDataPortalInvokeComplete()

virtual void Csla.Core.BusinessBase.DataPortal_OnDataPortalInvokeComplete ( DataPortalEventArgs e )

protectedvirtual

Called by the server-side DataPortal after calling the requested DataPortal_XYZ method.

Parameters

e	The DataPortalContext object passed to the DataPortal.

Definition at line 1266 of file Core/BusinessBase.cs.

◆ Delete()

virtual void Csla.Core.BusinessBase.Delete ( )

virtual

Marks the object for deletion.

The object will be deleted as part of the next save operation.

CSLA .NET supports both immediate and deferred deletion of objects. This method 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 method is called by the UI developer to mark the object for deletion.

To 'undelete' an object, use n-level undo as discussed in Chapters 2 and 3.

Implements Csla.Core.IEditableBusinessObject.

Definition at line 975 of file Core/BusinessBase.cs.

◆ EditChildComplete()

virtual void Csla.Core.BusinessBase.EditChildComplete ( Core.IEditableBusinessObject child )

protectedvirtual

Override this method to be notified when a child object's Core.BusinessBase.ApplyEdit method has completed.

Parameters

child The child object that was edited.

Definition at line 3418 of file Core/BusinessBase.cs.

◆ GetBrokenRules()

BrokenRulesCollection Csla.Core.BusinessBase.GetBrokenRules ( )

Gets the broken rules for this object

Implements Csla.Core.ICheckRules.

Definition at line 3817 of file Core/BusinessBase.cs.

◆ GetClone()

virtual object Csla.Core.BusinessBase.GetClone ( )

protectedvirtual

Creates a clone of the object.

Returns: A new object containing the exact data of the original object.

Definition at line 1044 of file Core/BusinessBase.cs.

◆ GetProperty()

object Csla.Core.BusinessBase.GetProperty ( IPropertyInfo propertyInfo )

protected

Gets a property's value as a specified type.

Parameters

propertyInfo PropertyInfo object containing property metadata.

If the user is not authorized to read the property value, the defaultValue value is returned as a result.

Definition at line 1896 of file Core/BusinessBase.cs.

◆ GetProperty() [1/7]

P Csla.Core.BusinessBase.GetProperty ( IPropertyInfo propertyInfo )

protected

Gets a property's managed field value, first checking authorization.

Template Parameters

P	Type of the property.

Parameters

propertyInfo PropertyInfo object containing property metadata.

If the user is not authorized to read the property value, the defaultValue value is returned as a result.

Definition at line 1925 of file Core/BusinessBase.cs.

◆ GetProperty() [2/7]

P Csla.Core.BusinessBase.GetProperty ( PropertyInfo propertyInfo )

protected

Gets a property's managed field value, first checking authorization.

Template Parameters

P	Type of the property.

Parameters

propertyInfo PropertyInfo object containing property metadata.

If the user is not authorized to read the property value, the defaultValue value is returned as a result.

Definition at line 1798 of file Core/BusinessBase.cs.

◆ GetProperty() [3/7]

P Csla.Core.BusinessBase.GetProperty< P >	(	PropertyInfo< P >	propertyInfo,
		P	field
	)

protected

Gets a property's value, first checking authorization.

Template Parameters

P	Type of the property.

Parameters

field	The backing field for the property.
propertyInfo	PropertyInfo object containing property metadata.

If the user is not authorized to read the property value, the defaultValue value is returned as a result.

Definition at line 1707 of file Core/BusinessBase.cs.

◆ GetProperty() [4/7]

P Csla.Core.BusinessBase.GetProperty< P >	(	PropertyInfo< P >	propertyInfo,
		P	field,
		P	defaultValue,
		Security.NoAccessBehavior	noAccess
	)

protected

Gets a property's value, first checking authorization.

Template Parameters

P	Type of the property.

Parameters

field	The backing field for the property.
propertyInfo	PropertyInfo object containing property metadata.
defaultValue	Value to be returned if the user is not authorized to read the property.
noAccess	True if an exception should be thrown when the user is not authorized to read this property.

Definition at line 1728 of file Core/BusinessBase.cs.

◆ GetProperty() [5/7]

P Csla.Core.BusinessBase.GetProperty< P >	(	PropertyInfo< P >	propertyInfo,
		Security.NoAccessBehavior	noAccess
	)

protected

Gets a property's value as a specified type, first checking authorization.

Template Parameters

P	Type of the property.

Parameters

propertyInfo	PropertyInfo object containing property metadata.
noAccess	True if an exception should be thrown when the user is not authorized to read this property.

If the user is not authorized to read the property value, the defaultValue value is returned as a result.

Definition at line 1869 of file Core/BusinessBase.cs.

◆ GetProperty() [6/7]

P Csla.Core.BusinessBase.GetProperty< P >	(	string	propertyName,
		P	field,
		P	defaultValue
	)

protected

Gets a property's value, first checking authorization.

Template Parameters

P	Type of the property.

Parameters

field	The backing field for the property.
propertyName	The name of the property.
defaultValue	Value to be returned if the user is not authorized to read the property.

If the user is not authorized to read the property value, the defaultValue value is returned as a result.

Definition at line 1654 of file Core/BusinessBase.cs.

◆ GetProperty() [7/7]

P Csla.Core.BusinessBase.GetProperty< P >	(	string	propertyName,
		P	field,
		P	defaultValue,
		Security.NoAccessBehavior	noAccess
	)

protected

Gets a property's value, first checking authorization.

Template Parameters

P	Type of the property.

Parameters

field	The backing field for the property.
propertyName	The name of the property.
defaultValue	Value to be returned if the user is not authorized to read the property.
noAccess	True if an exception should be thrown when the user is not authorized to read this property.

Definition at line 1675 of file Core/BusinessBase.cs.

◆ GetPropertyConvert< F, P >() [1/4]

P Csla.Core.BusinessBase.GetPropertyConvert< F, P > ( PropertyInfo< F > propertyInfo )

protected

Gets a property's value from the list of managed field values, first checking authorization, and converting the value to an appropriate type.

Template Parameters

F	Type of the field.
P	Type of the property.

Parameters

propertyInfo PropertyInfo object containing property metadata.

If the user is not authorized to read the property value, the defaultValue value is returned as a result.

Definition at line 1821 of file Core/BusinessBase.cs.

◆ GetPropertyConvert< F, P >() [2/4]

P Csla.Core.BusinessBase.GetPropertyConvert< F, P >	(	PropertyInfo< F >	propertyInfo,
		F	field
	)

protected

Gets a property's value as a specified type, first checking authorization.

Template Parameters

F	Type of the field.
P	Type of the property.

Parameters

field	The backing field for the property.
propertyInfo	PropertyInfo object containing property metadata.

If the user is not authorized to read the property value, the defaultValue value is returned as a result.

Definition at line 1752 of file Core/BusinessBase.cs.

◆ GetPropertyConvert< F, P >() [3/4]

P Csla.Core.BusinessBase.GetPropertyConvert< F, P >	(	PropertyInfo< F >	propertyInfo,
		F	field,
		Security.NoAccessBehavior	noAccess
	)

protected

Gets a property's value as a specified type, first checking authorization.

Template Parameters

F	Type of the field.
P	Type of the property.

Parameters

field	The backing field for the property.
propertyInfo	PropertyInfo object containing property metadata.
noAccess	True if an exception should be thrown when the user is not authorized to read this property.

If the user is not authorized to read the property value, the defaultValue value is returned as a result.

Definition at line 1779 of file Core/BusinessBase.cs.

◆ GetPropertyConvert< F, P >() [4/4]

P Csla.Core.BusinessBase.GetPropertyConvert< F, P >	(	PropertyInfo< F >	propertyInfo,
		Security.NoAccessBehavior	noAccess
	)

protected

Gets a property's value from the list of managed field values, first checking authorization, and converting the value to an appropriate type.

Template Parameters

F	Type of the field.
P	Type of the property.

Parameters

propertyInfo	PropertyInfo object containing property metadata.
noAccess	True if an exception should be thrown when the user is not authorized to read this property.

If the user is not authorized to read the property value, the defaultValue value is returned as a result.

Definition at line 1847 of file Core/BusinessBase.cs.

◆ GetRegisteredRules()

BusinessRuleManager Csla.Core.BusinessBase.GetRegisteredRules ( )

protected

Gets the registered rules.

Only for unit testing and not visible to code.

Returns

Definition at line 1133 of file Core/BusinessBase.cs.

◆ Initialize()

virtual void Csla.Core.BusinessBase.Initialize ( )

protectedvirtual

Override this method to set up event handlers so user code in a partial class can respond to events raised by generated code.

Definition at line 84 of file Core/BusinessBase.cs.

◆ IsPropertyBusy() [1/2]

virtual bool Csla.Core.BusinessBase.IsPropertyBusy ( Csla.Core.IPropertyInfo property )

virtual

Gets a value indicating whether a specific property is busy (has a currently executing async rule).

Parameters

property Property to check.

Definition at line 3176 of file Core/BusinessBase.cs.

◆ IsPropertyBusy() [2/2]

bool Csla.Core.BusinessBase.IsPropertyBusy ( string propertyName )

Gets a value indicating whether a specific property is busy (has a currently executing async rule).

Parameters

propertyName Name of the property.

Definition at line 3189 of file Core/BusinessBase.cs.

◆ LazyGetProperty()

P Csla.Core.BusinessBase.LazyGetProperty< P >	(	PropertyInfo< P >	property,
		Func< P >	valueGenerator
	)

protected

Lazily initializes a property and returns the resulting value.

Template Parameters

P	Type of the property.

Parameters

property	PropertyInfo object containing property metadata.
valueGenerator	Method returning the new value.

Returns

If the user is not authorized to read the property value, the defaultValue value is returned as a result.

Definition at line 1943 of file Core/BusinessBase.cs.

◆ LazyGetPropertyAsync()

P Csla.Core.BusinessBase.LazyGetPropertyAsync< P >	(	PropertyInfo< P >	property,
		Task< P >	factory
	)

protected

Lazily initializes a property and returns the resulting value.

Template Parameters

P	Type of the property.

Parameters

property	PropertyInfo object containing property metadata.
factory	Async method returning the new value.

Returns

Note that the first value returned is almost certainly the defaultValue because the value is initialized asynchronously. The real value is provided later along with a PropertyChanged event to indicate the value has changed.

If the user is not authorized to read the property value, the defaultValue value is returned as a result.

Definition at line 1984 of file Core/BusinessBase.cs.

◆ LazyReadProperty()

P Csla.Core.BusinessBase.LazyReadProperty< P >	(	PropertyInfo< P >	property,
		Func< P >	valueGenerator
	)

protected

Gets a property's value as a specified type.

Template Parameters

P	Type of the property.

Parameters

property	PropertyInfo object containing property metadata.
valueGenerator	Method returning the new value.

Definition at line 2102 of file Core/BusinessBase.cs.

◆ LazyReadPropertyAsync()

P Csla.Core.BusinessBase.LazyReadPropertyAsync< P >	(	PropertyInfo< P >	property,
		Task< P >	factory
	)

protected

Gets a property's value as a specified type.

Template Parameters

P	Type of the property.

Parameters

property	PropertyInfo object containing property metadata.
factory	Async method returning the new value.

Definition at line 2121 of file Core/BusinessBase.cs.

◆ LoadProperty()

virtual void Csla.Core.BusinessBase.LoadProperty	(	IPropertyInfo	propertyInfo,
		object	newValue
	)

protectedvirtual

Loads a property's managed field with the supplied value.

Parameters

propertyInfo	PropertyInfo object containing property metadata.
newValue	The new value for the property.

No authorization checks occur when this method is called, and no PropertyChanging or PropertyChanged events are raised. Loading values does not cause validation rules to be invoked.

Definition at line 2933 of file Core/BusinessBase.cs.

◆ LoadProperty()

void Csla.Core.BusinessBase.LoadProperty< P >	(	PropertyInfo< P >	propertyInfo,
		P	newValue
	)

protected

Loads a property's managed field with the supplied value.

Template Parameters

P	Type of the property.

Parameters

propertyInfo	PropertyInfo object containing property metadata.
newValue	The new value for the property.

No authorization checks occur when this method is called, and no PropertyChanging or PropertyChanged events are raised. Loading values does not cause validation rules to be invoked.

Definition at line 2650 of file Core/BusinessBase.cs.

◆ LoadPropertyAsync< R >()

void Csla.Core.BusinessBase.LoadPropertyAsync< R >	(	PropertyInfo< R >	property,
		Task< R >	factory
	)

protected

Load a property from an async method.

Template Parameters

R

Parameters

property
factory

Definition at line 3080 of file Core/BusinessBase.cs.

◆ LoadPropertyConvert< P, F >()

void Csla.Core.BusinessBase.LoadPropertyConvert< P, F >	(	PropertyInfo< P >	propertyInfo,
		F	newValue
	)

protected

Loads a property's managed field with the supplied value.

Parameters

propertyInfo	PropertyInfo object containing property metadata.
newValue	The new value for the property.

No authorization checks occur when this method is called, and no PropertyChanging or PropertyChanged events are raised. Loading values does not cause validation rules to be invoked.

Definition at line 2595 of file Core/BusinessBase.cs.

◆ LoadPropertyMarkDirty()

virtual bool Csla.Core.BusinessBase.LoadPropertyMarkDirty	(	IPropertyInfo	propertyInfo,
		object	newValue
	)

protectedvirtual

Loads a property's managed field with the supplied value.

Parameters

propertyInfo	PropertyInfo object containing property metadata.
newValue	The new value for the property.

No authorization checks occur when this method is called, and no PropertyChanging or PropertyChanged events are raised. Loading values does not cause validation rules to be invoked.

Definition at line 2850 of file Core/BusinessBase.cs.

◆ LoadPropertyMarkDirty()

bool Csla.Core.BusinessBase.LoadPropertyMarkDirty< P >	(	PropertyInfo< P >	propertyInfo,
		P	newValue
	)

protected

Loads a property's managed field with the supplied value and mark field as dirty if value is modified.

Template Parameters

P	Type of the property.

Parameters

propertyInfo	PropertyInfo object containing property metadata.
newValue	The new value for the property.

No authorization checks occur when this method is called, and no PropertyChanging or PropertyChanged events are raised. Loading values does not cause validation rules to be invoked.

Definition at line 2695 of file Core/BusinessBase.cs.

◆ MarkAsChild()

void Csla.Core.BusinessBase.MarkAsChild ( )

protected

Marks the object as being a child object.

Definition at line 950 of file Core/BusinessBase.cs.

◆ MarkBusy()

void Csla.Core.BusinessBase.MarkBusy ( )

protected

Mark the object as busy (it is running an async operation).

Definition at line 3098 of file Core/BusinessBase.cs.

◆ MarkClean()

void Csla.Core.BusinessBase.MarkClean ( )

protected

Forces the object's IsDirty flag to false.

This method is normally called automatically and is not intended to be called manually.

Definition at line 444 of file Core/BusinessBase.cs.

◆ MarkDeleted()

void Csla.Core.BusinessBase.MarkDeleted ( )

protected

Marks an object for deletion.

This also marks the object as being dirty.

You should call this method in your business logic in the case that you want to have the object deleted when it is saved to the database.

Definition at line 320 of file Core/BusinessBase.cs.

◆ MarkDirty() [1/2]

void Csla.Core.BusinessBase.MarkDirty ( )

protected

Marks an object as being dirty, or changed.

You should call this method in your business logic any time the object's internal data changes. Any time any instance variable changes within the object, this method should be called to tell CSLA .NET that the object's data has been changed.

Marking an object as dirty does two things. First it ensures that CSLA .NET will properly save the object as appropriate. Second, it causes CSLA .NET to tell Windows Forms data binding that the object's data has changed so any bound controls will update to reflect the new values.

Definition at line 344 of file Core/BusinessBase.cs.

◆ MarkDirty() [2/2]

void Csla.Core.BusinessBase.MarkDirty ( bool suppressEvent )

protected

Marks an object as being dirty, or changed.

Parameters

suppressEvent true to supress the PropertyChanged event that is otherwise raised to indicate that the object's state has changed.

Definition at line 357 of file Core/BusinessBase.cs.

◆ MarkIdle()

void Csla.Core.BusinessBase.MarkIdle ( )

protected

Mark the object as not busy (it is not running an async operation).

Definition at line 3112 of file Core/BusinessBase.cs.

◆ MarkNew()

virtual void Csla.Core.BusinessBase.MarkNew ( )

protectedvirtual

Marks the object as being a new object.

This also marks the object as being dirty and ensures that it is not marked for deletion.

Newly created objects are marked new by default. You should call this method in the implementation of DataPortal_Update when the object is deleted (due to being marked for deletion) to indicate that the object no longer reflects data in the database.

If you override this method, make sure to call the base implementation after executing your new code.

Definition at line 277 of file Core/BusinessBase.cs.

◆ MarkOld()

virtual void Csla.Core.BusinessBase.MarkOld ( )

protectedvirtual

Marks the object as being an old (not new) object.

This also marks the object as being unchanged (not dirty).

You should call this method in the implementation of DataPortal_Fetch to indicate that an existing object has been successfully retrieved from the database.

You should call this method in the implementation of DataPortal_Update to indicate that a new object has been successfully inserted into the database.

If you override this method, make sure to call the base implementation after executing your new code.

Definition at line 304 of file Core/BusinessBase.cs.

◆ MetaPropertyHasChanged()

virtual void Csla.Core.BusinessBase.MetaPropertyHasChanged ( string name )

protectedvirtual

Raises OnPropertyChanged for meta properties (IsXYZ) when PropertyChangedMode is not Windows

Parameters

name	meta property name that has cchanged.

Definition at line 398 of file Core/BusinessBase.cs.

◆ OnAddEventHooks()

virtual void Csla.Core.BusinessBase.OnAddEventHooks ( IBusinessObject child )

protectedvirtual

Hook child object events.

Parameters

child Child object.

Definition at line 1453 of file Core/BusinessBase.cs.

◆ OnApplicationContextSet()

override void Csla.Core.BusinessBase.OnApplicationContextSet ( )

protectedvirtual

Method invoked after ApplicationContext is available.

Reimplemented from Csla.Core.UndoableBase.

Definition at line 70 of file Core/BusinessBase.cs.

◆ OnBusyChanged()

virtual void Csla.Core.BusinessBase.OnBusyChanged ( BusyChangedEventArgs args )

protectedvirtual

Raise the BusyChanged event.

Parameters

args	Event args.

Definition at line 3160 of file Core/BusinessBase.cs.

◆ OnChildChanged()

virtual void Csla.Core.BusinessBase.OnChildChanged ( ChildChangedEventArgs e )

protectedvirtual

Raises the ChildChanged event, indicating that a child object has been changed.

Parameters

e	ChildChangedEventArgs object.

Definition at line 3270 of file Core/BusinessBase.cs.

◆ OnDeserialized()

virtual void Csla.Core.BusinessBase.OnDeserialized ( System.Runtime.Serialization.StreamingContext context )

protectedvirtual

This method is called on a newly deserialized object after deserialization is complete.

Parameters

context Serialization context object.

Reimplemented in Csla.Test.Silverlight.PropertyGetSet.AbstractGetSet< T >.

Definition at line 1431 of file Core/BusinessBase.cs.

◆ OnErrorsChanged()

virtual void Csla.Core.BusinessBase.OnErrorsChanged ( string propertyName )

protectedvirtual

Call to indicate that errors have changed for a property.

Parameters

propertyName Name of the property.

Definition at line 1382 of file Core/BusinessBase.cs.

◆ OnGetChildren()

override void Csla.Core.BusinessBase.OnGetChildren	(	Csla.Serialization.Mobile.SerializationInfo	info,
		Csla.Serialization.Mobile.MobileFormatter	formatter
	)

protected

Override this method to insert your child object references into the MobileFormatter serialzation stream.

Parameters

info	Object containing the data to serialize.
formatter	Reference to MobileFormatter instance. Use this to convert child references to/from reference id values.

Definition at line 3607 of file Core/BusinessBase.cs.

◆ OnGetState()

override void Csla.Core.BusinessBase.OnGetState	(	Csla.Serialization.Mobile.SerializationInfo	info,
		StateMode	mode
	)

protected

Override this method to insert your field values into the MobileFormatter serialzation stream.

Parameters

info	Object containing the data to serialize.
mode	The StateMode indicating why this method was invoked.

Definition at line 3557 of file Core/BusinessBase.cs.

◆ OnPropertyChanged()

override void Csla.Core.BusinessBase.OnPropertyChanged ( IPropertyInfo propertyInfo )

protectedvirtual

Call this method to raise the PropertyChanged event for a specific property.

Parameters

propertyInfo PropertyInfo of the property that has changed.

This method may be called by properties in the business class to indicate the change in a specific property.

Reimplemented from Csla.Core.BindableBase.

Definition at line 1398 of file Core/BusinessBase.cs.

◆ OnRemoveEventHooks()

virtual void Csla.Core.BusinessBase.OnRemoveEventHooks ( IBusinessObject child )

protectedvirtual

Unhook child object events.

Parameters

child Child object.

Definition at line 1495 of file Core/BusinessBase.cs.

◆ OnSetChildren()

override void Csla.Core.BusinessBase.OnSetChildren	(	Csla.Serialization.Mobile.SerializationInfo	info,
		Csla.Serialization.Mobile.MobileFormatter	formatter
	)

protected

Override this method to retrieve your child object references from the MobileFormatter serialzation stream.

Parameters

info	Object containing the data to serialize.
formatter	Reference to MobileFormatter instance. Use this to convert child references to/from reference id values.

Definition at line 3637 of file Core/BusinessBase.cs.

◆ OnSetState()

override void Csla.Core.BusinessBase.OnSetState	(	Csla.Serialization.Mobile.SerializationInfo	info,
		StateMode	mode
	)

protected

Override this method to retrieve your field values from the MobileFormatter serialzation stream.

Parameters

info	Object containing the data to serialize.
mode	The StateMode indicating why this method was invoked.

Definition at line 3581 of file Core/BusinessBase.cs.

◆ OnUnhandledAsyncException() [1/2]

virtual void Csla.Core.BusinessBase.OnUnhandledAsyncException ( ErrorEventArgs error )

protectedvirtual

Raises the UnhandledAsyncException event.

Parameters

error Args parameter.

Definition at line 3217 of file Core/BusinessBase.cs.

◆ OnUnhandledAsyncException() [2/2]

void Csla.Core.BusinessBase.OnUnhandledAsyncException	(	object	originalSender,
		Exception	error
	)

protected

Raises the UnhandledAsyncException event.

Parameters

originalSender	Original sender of the event.
error	Exception object.

Definition at line 3230 of file Core/BusinessBase.cs.

◆ OnValidationComplete()

virtual void Csla.Core.BusinessBase.OnValidationComplete ( )

protectedvirtual

Raises the ValidationComplete event

Definition at line 1078 of file Core/BusinessBase.cs.

◆ PropertyHasChanged()

virtual void Csla.Core.BusinessBase.PropertyHasChanged ( Csla.Core.IPropertyInfo property )

protectedvirtual

Performs processing required when a property has changed.

Parameters

property Property that has changed.

This method calls CheckRules(propertyName), MarkDirty and OnPropertyChanged(propertyName). MarkDirty is called such that no event is raised for IsDirty, so only the specific property changed event for the current property is raised.

Definition at line 383 of file Core/BusinessBase.cs.

◆ PropertyIsLoading()

bool Csla.Core.BusinessBase.PropertyIsLoading ( IPropertyInfo propertyInfo )

protected

Gets a value indicating whether a lazy loaded property is currently being retrieved.

Parameters

propertyInfo Property to check.

Returns

Definition at line 1959 of file Core/BusinessBase.cs.

◆ ReadProperty()

virtual object Csla.Core.BusinessBase.ReadProperty ( IPropertyInfo propertyInfo )

protectedvirtual

Gets a property's value.

Parameters

propertyInfo PropertyInfo object containing property metadata.

Definition at line 2065 of file Core/BusinessBase.cs.

◆ ReadProperty()

P Csla.Core.BusinessBase.ReadProperty ( PropertyInfo propertyInfo )

protected

Gets a property's value as a specified type.

Template Parameters

P	Type of the property.

Parameters

propertyInfo PropertyInfo object containing property metadata.

Definition at line 2033 of file Core/BusinessBase.cs.

◆ ReadPropertyConvert< F, P >()

P Csla.Core.BusinessBase.ReadPropertyConvert< F, P > ( PropertyInfo< F > propertyInfo )

protected

Gets a property's value from the list of managed field values, converting the value to an appropriate type.

Template Parameters

F	Type of the field.
P	Type of the property.

Parameters

propertyInfo PropertyInfo object containing property metadata.

Definition at line 2020 of file Core/BusinessBase.cs.

◆ RegisterMethod() [1/2]

static Csla.Core.IMemberInfo Csla.Core.BusinessBase.RegisterMethod	(	Type	objectType,
		IMemberInfo	info
	)

staticprotected

Indicates that the specified method belongs to the type.

Parameters

objectType	Type of object to which the method belongs.
info	IMemberInfo object for the property.

Returns: The provided IMemberInfo object.

Definition at line 1579 of file Core/BusinessBase.cs.

◆ RegisterMethod() [2/2]

static MethodInfo Csla.Core.BusinessBase.RegisterMethod	(	Type	objectType,
		string	methodName
	)

staticprotected

Indicates that the specified method belongs to the type.

Parameters

objectType	Type of object to which the method belongs.
methodName	Name of the method.

Returns: The provided IMemberInfo object.

Definition at line 1600 of file Core/BusinessBase.cs.

◆ RegisterProperty()

static PropertyInfo< P > Csla.Core.BusinessBase.RegisterProperty< P >	(	Type	objectType,
		PropertyInfo< P >	info
	)

staticprotected

Indicates that the specified property belongs to the type.

Template Parameters

P	Type of property.

Parameters

objectType	Type of object to which the property belongs.
info	PropertyInfo object for the property.

Returns: The provided IPropertyInfo object.

Definition at line 1627 of file Core/BusinessBase.cs.

◆ RemoveEventHooks()

void Csla.Core.BusinessBase.RemoveEventHooks ( IBusinessObject child )

protected

For internal use only.

Parameters

child Child object.

Definition at line 1485 of file Core/BusinessBase.cs.

◆ SetParent()

virtual void Csla.Core.BusinessBase.SetParent ( Core.IParent parent )

protectedvirtual

Used by BusinessListBase as a child object is created to tell the child object about its parent.

Parameters

parent A reference to the parent collection object.

Definition at line 151 of file Core/BusinessBase.cs.

◆ SetProperty()

void Csla.Core.BusinessBase.SetProperty	(	IPropertyInfo	propertyInfo,
		object	newValue
	)

protected

Sets a property's managed field with the supplied value, and then calls PropertyHasChanged if the value does change.

Parameters

propertyInfo	PropertyInfo object containing property metadata.
newValue	The new value for the property.

If the user is not authorized to change the property a SecurityException is thrown.

Definition at line 2530 of file Core/BusinessBase.cs.

◆ SetProperty() [1/6]

void Csla.Core.BusinessBase.SetProperty< P >	(	IPropertyInfo	propertyInfo,
		P	newValue
	)

protected

Sets a property's managed field with the supplied value, and then calls PropertyHasChanged if the value does change.

Template Parameters

P	Type of the property.

Parameters

propertyInfo	PropertyInfo object containing property metadata.
newValue	The new value for the property.

If the user is not authorized to change the property a SecurityException is thrown.

Definition at line 2572 of file Core/BusinessBase.cs.

◆ SetProperty() [2/6]

void Csla.Core.BusinessBase.SetProperty< P >	(	PropertyInfo< P >	propertyInfo,
		P	newValue
	)

protected

Sets a property's managed field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change.

Template Parameters

P	Property type.

Parameters

propertyInfo	PropertyInfo object containing property metadata.
newValue	The new value for the property.

If the user is not authorized to change the property, this overload throws a SecurityException.

Definition at line 2393 of file Core/BusinessBase.cs.

◆ SetProperty() [3/6]

void Csla.Core.BusinessBase.SetProperty< P >	(	PropertyInfo< P >	propertyInfo,
		P	newValue,
		Security.NoAccessBehavior	noAccess
	)

protected

Sets a property's managed field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change.

Template Parameters

P	Type of the property.

Parameters

propertyInfo	PropertyInfo object containing property metadata.
newValue	The new value for the property.
noAccess	True if an exception should be thrown when the user is not authorized to change this property.

Definition at line 2484 of file Core/BusinessBase.cs.

◆ SetProperty() [4/6]

void Csla.Core.BusinessBase.SetProperty< P >	(	PropertyInfo< P >	propertyInfo,
		ref P	field,
		P	newValue
	)

protected

Sets a property's backing field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change.

Parameters

field	A reference to the backing field for the property.
newValue	The new value for the property.
propertyInfo	PropertyInfo object containing property metadata.

If the user is not authorized to change the property, this overload throws a SecurityException.

Definition at line 2159 of file Core/BusinessBase.cs.

◆ SetProperty() [5/6]

void Csla.Core.BusinessBase.SetProperty< P >	(	string	propertyName,
		ref P	field,
		P	newValue
	)

protected

Sets a property's backing field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change.

Parameters

field	A reference to the backing field for the property.
newValue	The new value for the property.
propertyName	The name of the property.

If the user is not authorized to change the property, this overload throws a SecurityException.

Definition at line 2179 of file Core/BusinessBase.cs.

◆ SetProperty() [6/6]

void Csla.Core.BusinessBase.SetProperty< P >	(	string	propertyName,
		ref P	field,
		P	newValue,
		Security.NoAccessBehavior	noAccess
	)

protected

Sets a property's backing field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change.

Parameters

field	A reference to the backing field for the property.
newValue	The new value for the property.
propertyName	The name of the property.
noAccess	True if an exception should be thrown when the user is not authorized to change this property.

Definition at line 2253 of file Core/BusinessBase.cs.

◆ SetPropertyConvert< P, F >() [1/2]

void Csla.Core.BusinessBase.SetPropertyConvert< P, F >	(	PropertyInfo< P >	propertyInfo,
		F	newValue
	)

protected

Sets a property's managed field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change.

Parameters

propertyInfo	PropertyInfo object containing property metadata.
newValue	The new value for the property.

If the user is not authorized to change the property, this overload throws a SecurityException.

Definition at line 2411 of file Core/BusinessBase.cs.

◆ SetPropertyConvert< P, F >() [2/2]

void Csla.Core.BusinessBase.SetPropertyConvert< P, F >	(	PropertyInfo< P >	propertyInfo,
		F	newValue,
		Security.NoAccessBehavior	noAccess
	)

protected

Sets a property's managed field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change.

Parameters

propertyInfo	PropertyInfo object containing property metadata.
newValue	The new value for the property.
noAccess	True if an exception should be thrown when the user is not authorized to change this property.

Definition at line 2428 of file Core/BusinessBase.cs.

◆ SetPropertyConvert< P, V >() [1/3]

void Csla.Core.BusinessBase.SetPropertyConvert< P, V >	(	PropertyInfo< P >	propertyInfo,
		ref P	field,
		V	newValue
	)

protected

Sets a property's backing field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change.

Template Parameters

P	Type of the field being set.
V	Type of the value provided to the field.

Parameters

field	A reference to the backing field for the property.
newValue	The new value for the property.
propertyInfo	PropertyInfo object containing property metadata.

If the user is not authorized to change the property, this overload throws a SecurityException.

Definition at line 2205 of file Core/BusinessBase.cs.

◆ SetPropertyConvert< P, V >() [2/3]

void Csla.Core.BusinessBase.SetPropertyConvert< P, V >	(	PropertyInfo< P >	propertyInfo,
		ref P	field,
		V	newValue,
		Security.NoAccessBehavior	noAccess
	)

protected

Sets a property's backing field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change.

Template Parameters

P	Type of the field being set.
V	Type of the value provided to the field.

Parameters

field	A reference to the backing field for the property.
newValue	The new value for the property.
propertyInfo	PropertyInfo object containing property metadata.
noAccess	True if an exception should be thrown when the user is not authorized to change this property.

If the field value is of type string, any incoming null values are converted to string.Empty.

Definition at line 2234 of file Core/BusinessBase.cs.

◆ SetPropertyConvert< P, V >() [3/3]

void Csla.Core.BusinessBase.SetPropertyConvert< P, V >	(	string	propertyName,
		ref P	field,
		V	newValue,
		Security.NoAccessBehavior	noAccess
	)

protected

Sets a property's backing field with the supplied value, first checking authorization, and then calling PropertyHasChanged if the value does change.

Template Parameters

P	Type of the field being set.
V	Type of the value provided to the field.

Parameters

field	A reference to the backing field for the property.
newValue	The new value for the property.
propertyName	The name of the property.
noAccess	True if an exception should be thrown when the user is not authorized to change this property.

If the field value is of type string, any incoming null values are converted to string.Empty.

Definition at line 2328 of file Core/BusinessBase.cs.

◆ UndoChangesComplete()

override void Csla.Core.BusinessBase.UndoChangesComplete ( )

protectedvirtual

Called when an undo operation has completed.

This method resets the object as a result of deserialization and raises PropertyChanged events to notify data binding that the object has changed.

Reimplemented from Csla.Core.UndoableBase.

Definition at line 891 of file Core/BusinessBase.cs.

Property Documentation

◆ BrokenRulesCollection

virtual Rules.BrokenRulesCollection Csla.Core.BusinessBase.BrokenRulesCollection

get

Provides access to the readonly collection of broken business rules for this object.

Definition at line 1242 of file Core/BusinessBase.cs.

◆ BusinessRules

BusinessRules Csla.Core.BusinessBase.BusinessRules

getprotected

Provides access to the broken rules functionality.

This property is used within your business logic so you can easily call the AddRule() method to associate business rules with your object's properties.

Definition at line 1114 of file Core/BusinessBase.cs.

◆ BusyChanged

BusyChangedEventHandler Csla.Core.BusinessBase.BusyChanged

addremove

Event indicating that the IsBusy property has changed.

Definition at line 3150 of file Core/BusinessBase.cs.

◆ ChildChanged

EventHandler<Csla.Core.ChildChangedEventArgs> Csla.Core.BusinessBase.ChildChanged

addremove

Event raised when a child object has been changed.

Definition at line 3248 of file Core/BusinessBase.cs.

◆ DisableIEditableObject

bool Csla.Core.BusinessBase.DisableIEditableObject

getsetprotected

Gets or sets a value indicating whether the IEditableObject interface methods should be disabled for this object.

Defaults to False, indicating that the IEditableObject methods will behave normally.

If you disable the IEditableObject methods then Windows Forms data binding will no longer automatically call BeginEdit, CancelEdit or ApplyEdit on your object, and you will have to call these methods manually to get proper n-level undo behavior.

Definition at line 766 of file Core/BusinessBase.cs.

◆ FieldManager

FieldDataManager Csla.Core.BusinessBase.FieldManager

getprotected

Gets the PropertyManager object for this business object.

Definition at line 3374 of file Core/BusinessBase.cs.

◆ IsBusy

virtual bool Csla.Core.BusinessBase.IsBusy

get

Gets a value indicating if this object or its child objects are busy.

Definition at line 3126 of file Core/BusinessBase.cs.

◆ IsChild

bool Csla.Core.BusinessBase.IsChild

get

Returns true if this is a child (non-root) object.

Definition at line 942 of file Core/BusinessBase.cs.

◆ IsDeleted

bool Csla.Core.BusinessBase.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 205 of file Core/BusinessBase.cs.

◆ IsDirty

virtual bool Csla.Core.BusinessBase.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 232 of file Core/BusinessBase.cs.

◆ IsNew

bool Csla.Core.BusinessBase.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 183 of file Core/BusinessBase.cs.

◆ IsSavable

virtual bool Csla.Core.BusinessBase.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 469 of file Core/BusinessBase.cs.

◆ IsSelfBusy

virtual bool Csla.Core.BusinessBase.IsSelfBusy

get

Gets a value indicating if this object is busy.

Definition at line 3138 of file Core/BusinessBase.cs.

◆ IsSelfDirty

virtual bool Csla.Core.BusinessBase.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 257 of file Core/BusinessBase.cs.

◆ IsSelfValid

virtual bool Csla.Core.BusinessBase.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 BusinessRules 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 1228 of file Core/BusinessBase.cs.

◆ IsValid

virtual bool Csla.Core.BusinessBase.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.

By default this property relies on the underling BusinessRules 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. For instance, you should always override this method if your object has child objects, since the validity of this object is affected by the validity of all child objects.

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

Definition at line 1205 of file Core/BusinessBase.cs.

◆ Parent

Core.IParent Csla.Core.BusinessBase.Parent

get

Provide access to the parent reference for use in child object code.

This value will be Nothing for root objects.

Definition at line 140 of file Core/BusinessBase.cs.

◆ UnhandledAsyncException

EventHandler<ErrorEventArgs> Csla.Core.BusinessBase.UnhandledAsyncException

addremove

Event indicating that an exception occurred during the processing of an async operation.

Definition at line 3206 of file Core/BusinessBase.cs.

◆ ValidationComplete

EventHandler Csla.Core.BusinessBase.ValidationComplete

addremove

Event raised when validation is complete.

Definition at line 1060 of file Core/BusinessBase.cs.

Classes

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Properties

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ BusinessBase()

Member Function Documentation

◆ AcceptChangesComplete()

◆ AddBusinessRules()

◆ AddEventHooks()

◆ ApplyEdit()

◆ BeginEdit()

◆ CancelEdit()

◆ CanExecuteMethod() [1/3]

◆ CanExecuteMethod() [2/3]

◆ CanExecuteMethod() [3/3]

◆ CanReadProperty() [1/3]

◆ CanReadProperty() [2/3]

◆ CanReadProperty() [3/3]

◆ CanWriteProperty() [1/3]

◆ CanWriteProperty() [2/3]

◆ CanWriteProperty() [3/3]

◆ CheckObjectRules()

◆ CheckPropertyRules()

◆ Child_Create()

◆ Child_OnDataPortalException()

◆ Child_OnDataPortalInvoke()

◆ Child_OnDataPortalInvokeComplete()

◆ DataPortal_OnDataPortalException()

◆ DataPortal_OnDataPortalInvoke()

◆ DataPortal_OnDataPortalInvokeComplete()

◆ Delete()

◆ EditChildComplete()

◆ GetBrokenRules()

◆ GetClone()

◆ GetProperty()

◆ GetProperty< P >() [1/7]

◆ GetProperty< P >() [2/7]

◆ GetProperty< P >() [3/7]

◆ GetProperty< P >() [4/7]

◆ GetProperty< P >() [5/7]

◆ GetProperty< P >() [6/7]

◆ GetProperty< P >() [7/7]

◆ GetPropertyConvert< F, P >() [1/4]

◆ GetPropertyConvert< F, P >() [2/4]

◆ GetPropertyConvert< F, P >() [3/4]

◆ GetPropertyConvert< F, P >() [4/4]

◆ GetRegisteredRules()

◆ Initialize()

◆ IsPropertyBusy() [1/2]

◆ IsPropertyBusy() [2/2]

◆ LazyGetProperty< P >()

◆ LazyGetPropertyAsync< P >()

◆ LazyReadProperty< P >()

◆ LazyReadPropertyAsync< P >()

◆ LoadProperty()

◆ LoadProperty< P >()

◆ LoadPropertyAsync< R >()

◆ LoadPropertyConvert< P, F >()

◆ LoadPropertyMarkDirty()

◆ LoadPropertyMarkDirty< P >()

◆ MarkAsChild()

◆ MarkBusy()

◆ MarkClean()

◆ MarkDeleted()

◆ MarkDirty() [1/2]

◆ MarkDirty() [2/2]

◆ MarkIdle()

◆ MarkNew()

◆ MarkOld()

◆ MetaPropertyHasChanged()

◆ OnAddEventHooks()

◆ OnApplicationContextSet()

◆ OnBusyChanged()

◆ OnChildChanged()

◆ OnDeserialized()

◆ OnErrorsChanged()