BR.AN.PviServices .NET

Variable

重载。初始化一个新的变量类的实例。

Access

获取或设置该变量对象的访问类型。当获取和处理变量对象的过程数据时，对象属性控制方法。使用OR来组合不同的访问类型。

Active

获取或设置该实例的活动状态。

BitOffset

用于对变量进行逐位访问的偏移量。这个参数等于Pvi VA参数。变量寻址。默认值：-1 无变量寻址 使用变量寻址，链接对象可以从变量对象的过程数据中寻址子集。位寻址。使用位寻址，一个单独的位被定义为一个整数变量。在链接对象中，单个变量或数组的数据格式必须用变量类型布尔（VT=boolean）定义，或定义为可转换为布尔的类型。变量对象必须具有变量类型Integer（有符号或无符号）。位数是用VA参数指定的。位数从最低值位的0开始。例如。"VT=boolean VA=2" - 地址为第2位。如果变量对象是一个整数阵列，那么也可以在链接对象中定义一个布尔阵列。然后对每个单独的数组进行位寻址。

CastMode

这是一个支持的投掷/转换模式的组合。通过使用逻辑OR运算符将不同的模式结合起来。铸造模式参数是一个位编码。可调整的转换模式在位列表中用一个位表示。位0（值：1）PG2000或AS1.3--字符串变量。如果过程对象数据格式定义了i8或u8数组（1字节数组），那么在数据转换过程中，过程数据被视为字符串类型的单一变量（VT=string）。当读取数据格式时（访问类型TYPE或事件 "数据格式改变"），"字符串 "作为变量类型被返回（即实际数据格式="VT=i8 VL=1 VN=24 CM=1" ->返回数据格式VT=string VL=24 VN=1）。为此必须在过程对象中指定参数CM=1。如果只在链接对象中指定CM=1，那么就会返回实际的数据格式。注意：这种转换模式是为 "老 "PG2000或AS 1.3应用提供的。新的应用不应使用这些转换参数；相反，在PLC中还应将字符串变量定义为字符串变量。Bit 1 (Value: 2) 当从变量类型String（"VT=string"）转换到变量类型Integer（"VT=i8, VT=u32"）时，决定数字在字符串中的显示方式。十进制模式未被激活（位=0）。带有前导0位的字符串被解释为八进制（即-077，0012）。如果字符串以 "0x "或 "0X "开头，那么后面的位置被解释为十六进制（即0x1f, -0x56a9, 0xA3）。在所有其他情况下，该字符串被解释为十进制。十进制模式被激活（位=1）。字符串总是被解释为十进制。换句话说，带有前导零的字符串被解释为十进制；"0x123"（十六进制）不能被解释。位2（值：4）决定了当值范围被违反时，变量的行为。如果一个数字值不能在一个变量中表示，就会发生违反值范围的情况。例如。值130不能在i8类型的变量中表示（值范围：-128到127），而是在u8类型的变量中（值范围：0到255）。如果链接对象和过程对象使用不同的值范围的变量类型，那么在读或写方向上可能会发生值范围违规（即链接对象i32和过程对象i16中的变量类型，或者连接对象i8和过程对象u8中的变量类型）。值范围监控不活跃（位=0）。数据转换期间的组类型行为。组类型Integer到变量类型Integer的值范围较小。数字是截断的二进制。将组类型Float转换为具有较小数值范围的变量类型。如果数字不能在数值范围内表示，那么结果是未定义的。将String类型的变量转为Float或Integer类型。如果数字不能在数值范围内表示，那么结果是未定义的。组别类型Float或Integer到变量类型String。如果转换后的字符串长于字符串变量的长度（参数 "VL"），那么字符串将被截断。值范围监控是活动的（位=1）。在主动值范围监控期间的行为与极限监控的行为相同（见 "缩放和限制"）。当发生违反数值范围的行为时，取决于传输方向。写入变量数据（PviWrite）。当发生错误时，写入任务被停止。数据不被写入PLC变量。写入响应中会返回错误代码12014。此外，最大的可表示值与写入响应一起返回，并在事件数据缓冲区（如果指定）中发送给函数 "PviWrite "或 "PviWriteResultResponse "的应用程序。读取变量数据（PviRead或数据变化事件）。发送的是最大可表示值，而不是变量数据。不给出错误信息。在这两种情况下，在响应信息数据（结构T_RESPONSE_INFO）中设置Cast-overflow或Cast-underflow的各自retVal标志。有关响应信息数据的其他信息可以在 "PviGetResponseInfo "函数或回调函数SET_PVICALLBACK_DATA中找到。对字符串变量类型（"VT=string"）也进行了限制监测。当字符串数据长于变量的缓冲区大小时，就会发生违反极限的情况。例如。一个字符串 "abcdefg "+结尾的null不能完全放入数据格式为 "VT=string VL=4 "的变量中。retVal标志Cast-Overflow在发生违反字符串限制或违反数字变量的正值范围时被设置。Cast-Underflow只能发生在数值变量的负值范围内（有符号的Integer、Float）。在这种情况下，违反负值范围的信号会出现。如果一个字符串中包含不可解释的字符，并将其转换为另一种变量类型，这将被视为违反字符串限制。第3位（值：8）决定了变量类型Float（"VT=f32 ..."）到变量类型Integer（"VT=i8，VT=u32 ..."）的转换类型。四舍五入模式未被激活（位=0）。Float的小数点后面的所有位置都被截断了。例如：1.3 -> 1, -15.5 -> -15, 0.9999 -> 0. 舍入模式已激活（位=1）。Float的小数点后面的所有位置都被四舍五入（4/5）。例如：1.3 -> 1, -15.5 -> -16, 0.9999 -> 1。默认/标准转换=0。

ChangedStructMembers

如果该变量是一个结构体或数组，则获取改变后的成员名称阵列。

Convert

获取或设置变量值的转换类别

DataAlignment

Gets the alignment for structures.这只是结构在PLC上的对齐方式!!!

DataValid

获取实例数据的状态。

ExpandMembers

获取或设置结构体或数组的成员是否应该被扩展。如果设置为false，将不创建变量对象。二进制数据是一个字节数组，可以直接访问。

ForceValue

获取或设置

FullName

获取该实例的全名。

Hysteresis

Gets or sets 获取或设置该实例的hysteres-value。事件滞后只对单一变量或Integer或FloatingPoint类型的字段有效。事件滞后只对读而不是写的访问有效。

IECDataType

获取符合IEC标准的数据类型信息。

InitialValue

从PLC中获取INITIAL值。只要没有人调用ReadInitialValue或者该方法失败，就会变成空值。不要和InitialValue混为一谈！！。

InitValue

获取或设置用于创建命令的值。如果没有设置或为空，将不会被使用。你不能把InitialValue和.Net混为一谈。

IODataPoints

IO数据点的集合。

IsConnected

获取或设置PviServices对象的连接状态

Item

重载。获取一个变量类型的数组元素。

Members

获取一个 MemberCollection类型的集合  ，该集合持有该变量的所有成员。只返回第一层嵌套的对象。使用StructureMembers获取所有对象的hashtable。

OwnerName

如果这是一个结构或数组成员，获得拥有变量对象的名称，否则将返回null。

Parent

获取该实例的父对象（父类型Cpu、任务或服务）。

Polling

获取或设置实例的轮询状态。作为行或PLC事件变量的操作模式。如果是 "false"，则监测过程数据的变化是在生产线或PLC上进行的。由于这个原因，PVI管理器不需要进行任何周期性的读取请求。

PviPathName

获取  该实例的PviPathName 。

ReadOnly

获取或设置该变量是否为只读。你也可以不使用这个成员，而是将成员Access设置为Access.Read。允许对变量对象的过程数据进行读取访问。如果没有指定这个属性，对变量数据的读取访问会被拒绝，错误为12035。此外，PVI管理器不执行任何周期性的读取请求。

RefreshTime

获取或设置该实例的刷新时间。

RuntimeObjectIndex

获取或设置INA2000的RuntimeObjectIndex的选项。对于具有起始索引！=0的数组，使用该选项。

Scaling

获取或设置一个用于数值操作的Scaling对象。

Scope

获取实例的范围。

StructMemberName

如果该变量是一个复杂数据类型的一部分，则获取结构元素的名称。该名称从第一个嵌套层开始。如果你为根项调用此方法，你将得到一个空字符串

StructName

如果该变量是结构类型，获取结构的名称。

StructureMembers

获取这个变量的所有结构成员的哈希图，而不是像Members那样只获取第一层嵌套的成员。不要向这个hashtable添加或删除对象。

SynchronizedDataAccess

只对ANSL连接有效!!!定义对PLC上变量数据的同步写/读访问 可能的设置。/SYNC=0 ...只有最大尺寸为4字节的单变量和单变量类型为双数（8字节浮点数）的变量才能确保数据的一致性。该设置与INA2000中变量的写/读访问相对应。如果整个结构或字段的数据需要持续传输，用户必须实施相应的措施（例如，使用握手变量）。/SYNC=1 ...对PLC上变量数据的写/读访问与任务类同步，从而保证了数据的一致性。通过同步的写/读访问，变量数据被复制到各自任务类的缓冲区中。在每个任务类周期中只进行一次拷贝程序。缓冲区的大小目前是4096字节。这导致了以下的限制。1.同步变量的最大数据量受限于缓冲区的大小。2.如果所有同步变量的数据大小都大于缓冲区的大小，那么复制过程将被分割成几个任务类周期。在这种情况下，可能无法观察到预定的刷新率或相关的变量数据的必要当前性。出于这个原因，同步的写/读访问应该被少用。

UserTag

获取或设置字符串类型的用户特定信息，用于服务器和客户端变量之间的互动

Value

根据WriteValueAutomatic 属性（事件：ValueWritten），获取实际读取的值或设置processvariable的值 。

WriteValueAutomatic

获取或设置此实例的WriteValueAutomatic状态。

ChangeConnection

使用这个成员函数来改变对象的连接。当该函数改变了连接时，ConnectionChanged事件将被触发。

Connect

重载。创建此实例到其processvariable的连接。

Disconnect

重载。在plc上断开其变量的这个实例的连接。

FromXmlTextReader

从xml配置文件中读取设备配置并更新baseObject。

GetMemberArrayLength

Call this member to get the array length of this instance.

GetMemberDataSize

Call this member to get the size of the datatype of this instance.

GetMemberDataType

Call this member to get the type code of this instance.

ReadExtendedTypeInfo

获取扩展类型信息（派生、枚举、比特-字符串和初始值）。

ReadMemberVariables

从xml配置文件中读取成员变量并更新var Object。验证ConfigurationFlags.VariableMembers是否被设置。如果服务对象被连接，这个标志将被移除。

ReadValue

重载。读取processvariable的实际值。

ReadValueEx

读取processvariable的实际值。

Remove

该方法从PviServices层次结构中删除实例引用。

SetTypeInfo

重载。帮助初始化数据类型信息。

Upload

如果实例的数据类型等于DataType.Structure，此方法将从plc上传此实例的所有成员和子成员。

WriteScaling

这个函数将实际定义的缩放点写到PLC的变量中。响应时将触发事件PropertyChanged(... Action.VariableScalingChange)

WriteValue

重载。写入实例的实际值。

Activated

当变量实例被激活时发生。

DataValidated

当值数据有效时发生。

Deactivated

当变量实例被停用时发生。

ExtendedTypeInfoRead

当变量的扩展类型信息被读取时出现。

ForcedOff

当实例的强制状态从ON变为OFF时发生（仅适用于SG3）。

ForcedOn

当实例的强制状态从OFF变为ON时发生（仅适用于SG3）。

Uploaded

当实例成员被上传时发生。

ValueChanged

当过程变量的值发生变化时出现。

ValueRead

当一个值被读取时发生。

ValueWritten

当一个值被写入时发生。