BcfTableLoad Method (IDictionaryString, Object, Boolean)

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

Loads the specified values into a row.

Namespace: CalculationWorks.BusinessModel
Assembly: CalculationWorks.BusinessModel (in CalculationWorks.BusinessModel.dll) Version: 4.0.0-beta7

Syntax

Copy

public BcfRow Load(
	IDictionary<string, Object> values,
	bool update = true
)

Public Function Load ( 
	values As IDictionary(Of String, Object),
	Optional update As Boolean = true
) As BcfRow

Parameters

values: Type: System.Collections.GenericIDictionaryString, Object
The values.
update (Optional): Type: SystemBoolean
true allows updating row with matching primary key.

Return Value

Type: BcfRow
The BcfRow the values were loaded.

Return Value

Type: BcfRow
The target row (added or modified).

Exceptions

Exception	Condition
InvalidOperationException	BcfDataSet is Locked. or update is true and multiple rows with matching primary keys are found.
BcfUpdateException	See exception for the reason.

Exception

Condition

InvalidOperationException

BcfDataSet is Locked.

update is true and multiple rows with matching primary keys are found.

BcfUpdateException

See exception for the reason.

Remarks

If update is true and a row with matching primary key is found this row will be updated; otherwise values are loaded into a new row.

The updates will be performed in order of column-index (lowest first).

When updating a row with RowState==Valid triggers will be invoked.