Parcel Merge Method NFX Class Library

[This is preliminary documentation and is subject to change.]

Merges other parcel instances into this one. A parcel type may support merging (when DataParcel attribute SupportsMerge is set to true) of data from other parcels/versions into this instance. This parcel must not be sealed as merge may change the payload in which case TRUE is returned. The parcel needs to be sealed again after the change. If a call to this method returns false, then nothing was changed as this instance already contains the latest data/could not be merged. Merging is used for version conflict resolution: servers check if the type of the updated parcel instance SupportsMerge, then if it does, Opens parcel and calls this method passing other versions in question to this method. The framework does not impose a limit on the supplied parcel types, however most of the parcel types support merge only with the same-typed parcel instances. IMPORTANT: The ordering of parcel versions is not guaranteed.

Namespace: NFX.DataAccess.Distributed
Assembly: NFX (in NFX.dll) Version: 3.0.0.1 (3.0.0.1)
Syntax

public bool Merge(
	IEnumerable<Parcel> others
)

Parameters

others
Type: OnlineSystem.Collections.Generic IEnumerable Parcel 
Other parcel versions/data

Return Value

Type: OnlineBoolean
True if Merge() generated newer version/changed payload. False when Merge did not/could not change existing parcel
See Also