IMinute.UpdateValuesConditionally Method
Function UpdateValuesConditionally( _
ByVal fieldToUpdate As String, _
ByVal value As Object, _
ByVal whereField As String, _
ByVal whereValue As Object, _
ByVal whereType As WhereConditionType, _
ByVal whereIsCaseSensitive As Boolean _
) As Boolean
This language is not supported or no code example is available.
Parameters
- fieldToUpdate
- string
The mnemonic of the minute field to be updated.
- value
- object
The new value to be set in the column.
- whereField
- string
The mnemonic of the minute field to be tested.
- whereValue
- object
The value to be tested in the condition.
- whereType
- WhereConditionType
The type of test to be performed.
- whereIsCaseSensitive
- bool
Indicates whether the test is case sensitive.
Return Value
booltrue if no error occurred, it doesn't matter if any value was updated or not (if the condition was not satisfied). false if an error occurred.
This method requires the internal cache to be up to date, which is ususally the case, but there are some exceptions and you need to refresh it manually, see below.
Some methods use the internal cache for retrieving the minutes data. This is for performance reasons, especially, when one minute
is accessed multiple times. These are (let's name them group 1):
GetFieldValue,
SetFieldValue,
SetFieldValue,
UpdateValuesConditionally,
IEstimateVersion.UpdateMinuteValues.
And there are some methods that modify the minutes data, but they don't update the internal cache for performance reasons. These are (let's name them group 2):
ClearRowValues,
DeleteRow,
InsertRows,
InsertSetAtRow,
InsertSetAtRow,
GroupRows,
UngroupRows,
UpdateRowsFromDatabases.
So if you use the methods from group 2, you should update the internal cache manually before you call any method from the group 1. The cached data can be updated and retrieved with GetFullData method. You can update the cache also with the IWbs.Refresh method, but is it slower, because it does much more work.
See IMinute documentation for details about hidden "FreeField" field.
function to get info about these tasks. GetMultipleTaskInGanttAssignation field refers to only one task, the function returns a string which contains the unique description of the task. When the TaskInGantt field refers to several tasks, the function returns "<Multi>". Then you have to use the TaskInGantt When theFor historical reasons, this method doesn't throw any exception in case of any error. Instead, the error will be stored as a global error (if it was empty) in IGlobalErrors