SetChildDirty Method (DateTime)
For the latest version of Commerce Server 2007 Help, see the Microsoft Web site.
Propagates change notifications, using the specified date and time generated by the child class that made the call.
Namespace: Microsoft.CommerceServer.Runtime
Assembly: Microsoft.CommerceServer.Runtime (in Microsoft.CommerceServer.Runtime.dll)
Syntax
'Declaration
Public MustOverride Sub SetChildDirty ( _
modificationTime As DateTime _
)
'Usage
Dim instance As MappedStorageBase
Dim modificationTime As DateTime
instance.SetChildDirty(modificationTime)
public abstract void SetChildDirty(
DateTime modificationTime
)
public:
virtual void SetChildDirty(
DateTime modificationTime
) abstract
public abstract function SetChildDirty(
modificationTime : DateTime
)
Parameters
- modificationTime
Type: System..::.DateTime
A DateTime generated by the child class or one of its children.
Remarks
SetChildDirty(DateTime) is called by the SetDirty implementations within child classes to propagate the dirty state upward, eventually up to base OrderGroup-derived classes. Parent class implementations use this notification to update local "last updated" DateTime properties, and potentially to optimize update queries to storage.
Use this version of SetChildDirty(DateTime) when the child class propagates.
Root classes having no parent should implement this function as empty. Note that in the orders class hierarchy, only system-defined OrderGroup-derived classes can be root classes.
Examples
The following code example shows how to implement SetChildDirty(DateTime) for a parent class that is itself contained within a parent class.
using Microsoft.CommerceServer.Runtime;
class MyClass : MappedStorageBase
{
void SetChildDirty(DateTime modificationTime)
{
// Check to see if StorageLoadInProgress is set - if so, skip
// processing of this call.
if (!StorageLoadInProgress)
{
// If there is a local DateTime property that stores a "last
// modified" time,
// update it here with the value passed in.
// If this class is contained within a parent (e.g. an OrderForm
// or OrderGroup),
// notify that parent instance of a change in this class,
// propagating the DateTime
// value passed to us.
this.myParentRef.SetChildDirty(modificationTime);
}
}
}
Permissions
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.