AlternateBindingRetentionMode Property

Specifies whether the field should auto-release binding objects or retain them after they are created.
Public Property AlternateBindingRetentionMode As BindingRetentionMode
public BindingRetentionMode AlternateBindingRetentionMode {get; set;}

By default a field with an AlternateBinding creates a binding object for every cell whose value is accessed and then discards it after evaluating the binding so minimize the memory usage. This however means that every time an unbound cell's value is accessed, it will have to re-create the binding object. Even though this preserves memory, it may have adverse performance impact since the binding has to be re-created every time the unbound cell's value is needed. This adverse performance will be surfaced when a sort or group-by operation is performed on the field with a lot of records. When this property is set to Retain, the bindings will be retained and successive sort, group-by or any other operations that require accessing values of all the unbound cells will be less performance intensive.

Note: this property is ignored unless AlternateBinding is set to a binding.


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

See Also