Updatetaglist() - .Net (C#) - Siemens Simatic S7-1500 Function Manual

User interfaces (API)
7.6 API IInstances
Table 7- 135 UpdateTagList() - .NET (C#)
Syntax
Parameters
Return values
Exceptions
154
void UpdateTagList();
void UpdateTagList(
ETagListDetails in_TagListDetails
);
void UpdateTagList(
ETagListDetails in_TagListDetails,
bool in_IsHMIVisibleOnly
);
ERuntimeErrorCode UpdateTagList(
ETagListDetails in_TagListDetails,
bool in_IsHMIVisibleOnly,
string in_DataBlockFilterList
);
•
ETagListDetails in_TagListDetails:
Every combination of the following four areas:
IO: Inputs and Outputs
M: Bit memory
CT: Counters and Timers
DB: Data Blocks
The default setting is IOMCTDB.
Example: IOM reads only the tags from the area Inputs / Outputs and Bit
memory.
•
bool in_IsHMIVisibleOnly:
If , only tags marked with "HMI Visible" are read. The default setting is
true
.
true
•
string in_DataBlockFilterList:
A string that includes the name of all data blocks that are supposed to be
available in the tag table. The string must be in quotation marks.
Example: ""\"DB_1\", \"DB_2\" \"DB_3\"|\"DB_4\"\"DB_5\""
All characters within the quotation marks are interpreted as a DB name. If the
data block does not exist in the PLC program, it is not added to the tag table
memory. No error is triggered in the process.
For this list to be taken into consideration,
unequal to NULL and
None
Siemens.Simatic.Simulation.Runtime.SimulationRuntimeException
Runtime error code
ERuntimeError-
Code.InterfaceRemoved
ERuntimeErrorCode.Timeout
ERuntimeError-
Code.InstanceNotRunning
ERuntimeError-
Code.NotEnoughMemory
ERuntimeErrorCode.WrongArgument
in_DataBlockFilterList
has to contain "DB".
in_TagListDetails
Condition
The instance is not registered in Runtime
Manager.
The function does not return on time.
The process of the virtual controller is not
running.
More than 500000 entries are requested.
The syntax of
is invalid. The list has to be 3 characters
long; the first and last character have to
be a quotation mark.
Function Manual, 12/2017, A5E37039512-AB
has to be
in_DataBlockFilterList
S7-PLCSIM Advanced