NT_ADD_ROW (149)
Adds a row to a table.
Parameters
Adding a row to the local element:
int tableID = 1000;
string primaryKey = "Row 1";
int rowPosition = (int) protocol.NotifyProtocol(149/*NT_ADD_ROW*/ , tableID, primaryKey);
- tableID (int): ID of the table parameter.
- primaryKey (string): Primary key of the row that needs to be added.
Adding a row to a remote element:
uint dmaId = (uint)protocol.DataMinerID;
uint elementId = (uint)protocol.ElementID;
uint tableId = 6000;
uint[] ids = new uint[] { dmaId, elementId, tableId };
object[] rowData = new object[] { "Row 2", 100 };
int result = (int) protocol.NotifyDataMiner(149, ids, rowData);
- ids (uint[])
- ids[0]: DataMiner Agent ID
- ids[1]: Element ID
- ids[2]: Parameter ID
- rowData (object[]): The row data.
Return Value
- (int): The 1-based internal position of the row in the table.
Remarks
From DataMiner 9.5.0 [CU11]/9.5.14 [CU1] (RN 19707) onwards, NT_ADD_ROW (149) will no longer initialize a cell as 0.0 or an empty string when no value is provided for that cell.
To add a row with a specific timestamp:
int tableID = 1000; object rowData = new object[] { "Key 200", "S", "20.20" }; DateTime timeStamp = DateTime.Now - TimeSpan.FromDays(2); protocol.NotifyProtocol(149 /* NT_ADD_ROW */, tableId, new object[] { rowData, timeStamp });