IMinute.GetFieldValue Method

Returns a value of a specified field from a minute cell.
Function GetFieldValue( _ 
ByVal row As Integer, _ 
ByVal fieldMnemonic As String
) As Object
This language is not supported or no code example is available.
object GetFieldValue( 
int row
string fieldMnemonic 
)
This language is not supported or no code example is available.

Parameters

row
int

The line number of the row you want to get data from. The number is 1-based.

fieldMnemonic
string

The identifier (mnemonic) of the field.

Return Value

object

Depending upon the field type, it returns a string, a number or a date. See remarks for special field "TaskInGantt".

Remarks
 

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

When the TaskInGantt 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 GetMultipleTaskInGanttAssignation function to get info about these tasks.

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.

Version
 
Available since QDV 7.13.0001.

.NET Framework

Supported in: 4.8, 4.7, 4.6, 4.5.2

In this article

Definition