ProvideDescendantMapping Method

Invoked after the records are deleted to allow providing a mapping between the old dataitems for the descendant records and that of the new descendant records.

Syntax

Visual Basic

'Declaration
 
Public Overridable Function ProvideDescendantMapping( _
   ByVal descendants As IList(Of UndeleteRecordsStrategy.RecordInfo) _
) As IDictionary(Of UndeleteRecordsStrategy.RecordInfo,Object)

C#

public virtual IDictionary<UndeleteRecordsStrategy.RecordInfo,object> ProvideDescendantMapping( 
   IList<UndeleteRecordsStrategy.RecordInfo> descendants
)

Parameters

descendants

A list of UndeleteRecordsStrategy.RecordInfo instances that represent the descendant records

Return Value

A dictionary that provides map between the old data item and the new data item for the descendant records or null to indicate that the old items are not valid and therefore no mapping could take place.

Remarks

This method is invoked if the RestoreDescendantActions returns true and there were undo or redo actions associated with one or more descendants of the records that were deleted. This method provides a means to indicate what new data items are now associated with the previous data items. By default, this method will assume that the same data item instance is being used.

Note, this method may be called multiple times since it will be invoked separately for each set of descendant records. For example, if there were grandchild records of the delete records, this will first be invoked with the record info for the child records (i.e. the ancestors of those grandchild records).

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2