IMinute.SetFieldValue (Int32, Dictionary<StringObject>) Method

Writes values to a minute row.
Sub SetFieldValue( _ 
ByVal row As Integer, _ 
ByVal fieldValues As Dictionary(Of String, Object) _ 
)
This language is not supported or no code example is available.
void SetFieldValue( 
int row
Dictionary<string, object> fieldValues 
)
This language is not supported or no code example is available.

Parameters

row
int

The row number in the minute (1 - 9999).

fieldValues
Dictionary<string, object>

A dictionary where the key is the mnemonic of the field and the value is the field value. The value is either a string, a number, a date or an object of type IGanttTasksAssignation.

Exception type Condition

QdvApiException

A problem occurred.

Remarks
 
See IMinute documentation for details about hidden FreeField field.

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 the

For 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

Version
 
Available since QDV 7.13.0001.

.NET Framework

Supported in: 4.8, 4.7, 4.6, 4.5.2

In this article

Definition