GtmPropertiesMerger.Merge Method

Merges gtmData and additionalData to form new GtmData.

If additionalData can be enumerated as KeyValuePair<TKey, TValue> items, then the key-value pairs are merged. Otherwise, the public properties and their values are merged.

Namespace: CMS.Ecommerce
Assembly: CMS.Ecommerce (in CMS.Ecommerce.dll) Version: 12.0.0

Syntax

public static GtmData Merge(
	GtmData gtmData,
	Object additionalData,
	bool overwrite = false
)

Parameters

gtmData

Type: CMS.Ecommerce.GtmData
Source object to be merged with additionalData object.

additionalData

Type: System.Object
Properties of this object are merged with gtmData object.

overwrite (Optional)

Type: System.Boolean
Decides whether values of properties with the same name are substituted for values of additionalData object.

Return Value

Type: GtmData
New GtmData with combined properties and values of original gtmData and additionalData.

Exceptions

Exception	Condition
ArgumentNullException	Thrown when gtmData is null.
InvalidOperationException	Thrown when additionalData can be enumerated as KeyValuePair<TKey, TValue> items, but a null key is found.

Remarks

Objects properties are merged only on the first level.

Examples

Source object: new GtmData { a = 1, b = 2 }

Merge object: new { a = 3, c = 4 }

Rewrite equals false: new GtmData { a = 1, b = 2, c = 4 }

Rewrite equals false: new GtmData { a = 3, b = 2, c = 4 }