UpdateSpecific(Int32,Int32,Int32,String,Nullable<Int32>,Nullable<Boolean>,DBString,DBString,DBInt,DBInt,DBString,DBString,DBString,DBString,Nullable<DateTime>) Method
- Last UpdatedNov 06, 2025
- 3 minute read
The UpdateSpecific() method updates selected columns for the specified data log value record in the Data_Log_Value table.
This overload of the method includes the lastEditAt output parameter.
'Declaration
Public Overloads Shared Sub UpdateSpecific( _
ByVal sessionId As Integer, _
ByVal grpId As Integer, _
ByVal valueIndex As Integer, _
ByVal valueName As String, _
ByVal valueType As Nullable(Of Integer), _
ByVal editable As Nullable(Of Boolean), _
ByVal curValue As DBString, _
ByVal specId As DBString, _
ByVal meaning As DBInt, _
ByVal meaningToValueIndex As DBInt, _
ByVal spare1 As DBString, _
ByVal spare2 As DBString, _
ByVal spare3 As DBString, _
ByVal spare4 As DBString, _
ByRef lastEditAt As Nullable(Of Date) _
)
'Usage
Dim sessionId As Integer
Dim grpId As Integer
Dim valueIndex As Integer
Dim valueName As String
Dim valueType As Nullable(Of Integer)
Dim editable As Nullable(Of Boolean)
Dim curValue As DBString
Dim specId As DBString
Dim meaning As DBInt
Dim meaningToValueIndex As DBInt
Dim spare1 As DBString
Dim spare2 As DBString
Dim spare3 As DBString
Dim spare4 As DBString
Dim lastEditAt As Nullable(Of Date)
DataLogValue.UpdateSpecific(sessionId, grpId, valueIndex, valueName, valueType, editable, curValue, specId, meaning, meaningToValueIndex, spare1, spare2, spare3, spare4, lastEditAt)
public static void UpdateSpecific(
int sessionId,
int grpId,
int valueIndex,
string valueName,
Nullable<int> valueType,
Nullable<bool> editable,
DBString curValue,
DBString specId,
DBInt meaning,
DBInt meaningToValueIndex,
DBString spare1,
DBString spare2,
DBString spare3,
DBString spare4,
ref Nullable<DateTime> lastEditAt
)
Parameters
- sessionId
- Required. Holds the session ID and thus the user who is making this method call.
- grpId
- Required. Holds the ID of the data log group of the record to be updated.
- valueIndex
- Required. Holds the value index of the record to be updated.
- valueName
- Optional. Holds the column heading for the value.
- valueType
- Optional. Holds the enumeration for the value type. The default is 0.
- editable
- Optional. Holds the flag that, if set to true, specifies that the user can manually enter or modify the value. The default is true.
- curValue
- Optional. Holds the current value for this value.
- specId
- Optional. Holds the spec ID from which the data log’s runtime value is sourced for the current running job.
- meaning
- This parameter is not used by the system.
- meaningToValueIndex
- This parameter is not used by the system.
- spare1
- Optional. Holds the contents of the user-defined spare1 field.
- spare2
- Optional. Holds the contents of the user-defined spare2 field.
- spare3
- Optional. Holds the contents of the user-defined spare3 field.
- spare4
- Optional. Holds the contents of the user-defined spare4 field.
- lastEditAt
Optional. Holds the datetime when this record was added or last updated, for optimistic concurrency control. If provided, the passed value must match the last_edit_at value in the record for the update to succeed.
Output. Holds the datetime value when the record was updated by this called method.
Observe the following input parameter rules:
- Optional non-DB* parameters: Either enter a new value or leave the existing value unchanged by passing a null.
- Optional DB* parameters: To clear the existing value and enter an empty value, pass DB*.null (e.g., DBInt.null). To leave the existing value unchanged, pass a null.