INGEAR.NET.Logix

 

Tag.Name Property

Name - ControlLogix/CompactLogix native tag address

[Visual Basic]
NotOverridable Public Property Name As String _
    Implements ITag.Name
[C#]
public string Name {get; set;}

Property Value

A string representing the native tag address

Implements

ITag.Name

Remarks

  1. Tag.Name is not case sensitive

  2. Invalid characters (space)!@#$%^&*()-+=~`;<>?|{}"'

  3. Name must begin with alphabetical character or underscore

  4. Character after ':' must be alphanumeric

  5. Character after '.' must be alphanumeric

  6. Character after '[' must be numeric

  7. Character after '_' must be alphanumeric

  8. Character after ']' (if any) must be alphanumeric

  9. Name must end with alphanumeric or ']'

SYNTAX

CPU STATE

Tag.Name = "$CPU_STATE" see  Retrieve the state of the CPU

Controller Scope

 

  • Atomic Tag

Tag.Name = <atomic tagname>

  • Predefine Type Structure

Tag.Name = <name>

  • Predefined Type Member

Tag.Name = <name>.<member name>

  • User Defined Type Structure

Tag.Name = <name>

  • User Defined Type Member (UDT)

Tag.Name = <name>.<atomic tagname>

Program Scope

 

  • Atomic Types

Tag.Name = "PROGRAM:<program name>.<atomic tagname>

  • Predefined Structure

Tag.Name = "PROGRAM:<program name>.<name>

  • Predefine Types Member

Tag.Name = "PROGRAM:<program name>.<name>.<member name>

  • User Defined Type Structure

Tag.Name = "PROGRAM:<program name>.<name>

  • User Defined Types Member

Tag.Name = "PROGRAM:<program name>.<name>.<atomic tagname>

 

ATOMIC TYPE

Syntax

Example

BOOL

tagname

MyTag.Name = "BOOL_Tag"

BOOL (array)

arrayname[x]

arrayname[x.y]

arrayname[x.y.z]

MyTag.Name = "BoolArray[0]"

MyTag.Name = "BoolArray[1,2]"

MyTag.Name = "BoolArray[1,2,3]"

SINT

tagname

MyTag.Name = "SINT_Tag"

SINT (bit member)

tagname.<0-7>

MyTag.Name = "SINT_Tag.1"

SINT (array)

arrayname[x]

arrayname[x.y]

arrayname[x.y.z]

MyTag.Name = "SINT_Array[0]"

MyTag.Name = "SINT_Array[1,2]"

MyTag.Name = "SINT_Array[1,2,3]"

SINT (array bit member)

arrayname[x].<0-7>

arrayname[x.y].<0-7>

arrayname[x.y.z].<0-7>

MyTag.Name = "SINT_Array[0].1"

MyTag.Name = "SINT_Array[1,2].1"

MyTag.Name = "SINT_Array[1,2,3].1"

INT

tagname

MyTag.Name = "INT_Tag"

INT (bit member)

tagname.<0-15>

MyTag.Name = "INT_Tag.4"

INT (array)

arrayname[x]

arrayname[x.y]

arrayname[x.y.z]

MyTag.Name = "INT_Array[0]"

MyTag.Name = "INT_Array[1,2]"

MyTag.Name = "INT_Array[1,2,3]"

INT (array bit member)

arrayname[x].<0-15>

arrayname[x.y].<0-15>

arrayname[x.y.z].<0-15>

MyTag.Name = "INT_Array[0].4"

MyTag.Name = "INT_Array[1,2].4"

MyTag.Name = "INT_Array[1,2,3].4"

DINT

tagname

MyTag.Name = "DINT_Tag"

DINT (bit member)

tagname.<0-31>

MyTag.Name = "DINT_Tag.11"

DINT (array)

arrayname[x]

arrayname[x.y]

arrayname[x.y.z]

MyTag.Name = "DINT_Array[0]"

MyTag.Name = "DINT_Array[1,2]"

MyTag.Name = "DINT_Array[1,2,3]"

DINT (array bit member)

arrayname[x].<0-31>

arrayname[x.y].<0-31>

arrayname[x.y.z].<0-31>

MyTag.Name = "DINT_Array[0].11"

MyTag.Name = "DINT_Array[1,2].11"

MyTag.Name = "DINT_Array[1,2,3].11"

REAL

tagname

MyTag.Name = "REAL_Tag"

REAL (array)

arrayname[x]

arrayname[x.y]

arrayname[x.y.z]

MyTag.Name = "REAL_Array[0]"

MyTag.Name = "REAL_Array[1,2]"

MyTag.Name = "REAL_Array[1,2,3]"

STRING

tagname

MyTag.Name = "MyStringTag"

STRING (.LEN member)

 

tagname.LEN

 

MyTag.Name = "MyStringTag.LEN"

STRING (array)

arrayname[x]

arrayname[x.y]

arrayname[x.y.z]

MyTag.Name = "STRING_Array[0]"

MyTag.Name = "STRING_Array[1,2]"

MyTag.Name = "STRING_Array[1,2,3]"

UDT

tagname

MyTag.Name = "UDT_Name"

UDT (array)

arrayname[x]

arrayname[x.y]

arrayname[x.y.z]

MyTag.Name = "UDT_Array[0]"

MyTag.Name = "UDT_Array[1,2]"

MyTag.Name = "UDT_Array[1,2,3]"

 

 

 

Pre-Defined Types

Syntax

Example

ALARM

AXIS_CONSUMED

AXIS_GENERIC

AXIS_GENERIC_DRIVE

AXIS_SERVO

AXIS_SERVO_DRIVE

AXIS_VIRTUAL

CAM

CAM_PROFILE

CONNECTION_STATUS

CONTROL

COORDINATE_SYSTEM

COUNTER

DEADTIME

DERIVATIVE

DISCRETE_2STATE

DISCRETE_3STATE

DIVERSE_INPUT

DOMINANT_RESET

DOMINANT_SET

EMERGENCY_STOP

ENABLE_PENDANT

EXT_ROUTINE_CONTROL

EXT_ROUTINE_PARAMETERS

FBD_BIT_FIELD_DISTRIBUTE

FBD_BOOLEAN_AND

FBD_BOOLEAN_NOT

FBD_BOOLEAN_OR

FBD_BOOLEAN_XOR

FBD_COMPARE

FBD_CONVERT

FBD_COUNTER

FBD_LIMIT

FBD_LOGICAL

FBD_MASKED_MOVE

FBD_MASK_EQUAL

FBD_MASKED_MOVE

FBD_MATH

FBD_MATH_ADVANCED

FBD_ONESHOT

FBD_TIMER

FBD_TRUNCATE

FILTER_HIGH_PASS

FILTER_LOW_PASS

FILTER_NOTCH

FIVE_POS_MODE_SELECTOR

FLIP_FLOP_D

FLIP_FLOP_JK

FUNCTION_GENERATOR

HL_LIMIT

INTEGRATOR

LEAD_LAG

LEAD_LAG_SEC_ORDER

LIGHT_CURTAIN

MAXIMUM_CAPTURE

MESSAGE

MINIMUM_CAPTURE

MOTION_GROUP

MOTION_INSTRUCTION

MOVING_AVERAGE

MOVING_STD_DEV

MULTIPLEXER

OUTPUT_CAM

OUTPUT_COMPENSATION

PHASE

PHASE_INSTRUCTION

PID

PID_ENHANCED

PIDE_AUTOTUNE

POSITION_PROP

PROP_INT

PULSE_MULTIPLIER

RAMP_SOAK

RATE_LIMITER

REDUNDANT_INPUT

REDUNDANT_OUTPUT

S_CURVE

SCALE

SEC_ORDER_CONTROLLER

SELECT

SELECT_ENHANCED

SELECTABLE_NEGATE

SELECTED_SUMMER

SERIAL_PORT_CONTROL

SFC_ACTION

SFC_STEP

SFC_STOP

SPLIT_RANGE

TIMER

TOTALIZER

TWO_HAND_RUN_STATION

UP_DOWN_ACCUM

Type Name.<member name>

MyTag.Name = "MyTimer.PRE"

MyTag.Name = "MyCounter.ACC"

 

This property not is case sensitive.

Exceptions

Exception Type Condition
ArgumentNullException Thrown if Name is set to a null reference (Nothing in Visual Basic)

ArgumentException

Thrown Name parameter Length is less that 1 character.

Exception

Thrown if Name is an invalid format.

See Also

Tag Class | Logix Namespace