Namespace: IPS7Lnk.Advanced
Assemblies: IPS7LnkNet.Advanced.dll, IPS7LnkNet.Advanced.dll
The PlcDeviceConnection type exposes the following members.
Initializes a new instance of the PlcDeviceConnection class using the specified device
.
C#
protected PlcDeviceConnection(IPlcDevice device)
Parameters
device
IPlcDevice
The IPlcDevice associated with the new PlcDeviceConnection.
Exceptions
The device
is a null reference (Nothing in Visual Basic).
Represents the default timeout value that is used by the PlcDeviceConnection as initial value of all timeout properties.
C#
public static readonly int DefaultTimeout
Field Value
Int32
Occurs when a connection transitions into the closed state.
C#
public event EventHandler Closed
Occurs when a connection transitions into the closing state.
C#
public event EventHandler Closing
Occurs when a connection transitions into the connected state.
C#
public event EventHandler Connected
Occurs when a connection transitions into the connecting state.
C#
public event EventHandler Connecting
Occurs when a connection transitions into the disconnected state.
C#
public event EventHandler Disconnected
Occurs when a connection transitions into the faulted state.
C#
public event EventHandler Faulted
Occurs when a connection transitions into the opened state.
C#
public event EventHandler Opened
Occurs when a connection transitions into the opening state.
C#
public event EventHandler Opening
Occurs when a connection transitions into a different state.
C#
public event EventHandler<PlcDeviceConnectionStateChangedEventArgs> StateChanged
Gets or sets the time that is used to detect a connection break.
C#
public int BreakDetectionTimeout { get; set; }
Property Value
The time in milliseconds to detect a connection break.
Exceptions
The value specified is less than zero.
Remarks
The default value of this property is DefaultTimeout.
Gets the channel object used to communicate with the Device.
C#
protected PlcDeviceConnectionChannel Channel { get; }
Property Value
The PlcDeviceConnectionChannel used by the connection to operate on the Device this connection belongs. The PlcDeviceConnectionChannel returned can be used by one or more connections.
Remarks
Only in case there the last connection using a channel gets closed, the channel gets finally released. The shared use of channel objects takes only place in case there the UsePool property is set to the value true before Open is called. Any call to Open before setting the UsePool property to the value true will not cache a channel instance for pooling. Subsequent calls to Open after setting the UsePool property to the value true will share the same channel (in case there the end point and device setup of the connections opening match together).
Gets or sets the wait time before terminating the attempt to establish a connection.
C#
public int ConnectTimeout { get; set; }
Property Value
The time in milliseconds to wait for the connection to connect.
Exceptions
The value specified is less than zero.
Remarks
The default value of this property is DefaultTimeout.
Gets the IPlcDevice associated with the connection.
C#
public IPlcDevice Device { get; }
Property Value
The IPlcDevice associated with the connection.
Gets a value indicating whether the connection has been completely established to the device.
C#
public virtual bool IsConnected { get; }
Property Value
The value true, if the connection has been completely established; otherwise the value false.
Gets or sets the wait time before terminating the attempt to receive data.
C#
public int ReceiveTimeout { get; set; }
Property Value
The time in milliseconds to wait for the connection to receive.
Exceptions
The value specified is less than zero.
Remarks
The default value of this property is DefaultTimeout.
Gets or sets a value that indicates the current state of the connection.
C#
public PlcDeviceConnectionState State { get; protected set; }
Property Value
One of the members defined by the PlcDeviceConnectionState enumeration. Which specifies the current state of the connection.
Gets the status information provided by the software driver.
C#
public PlcStatus Status { get; }
Property Value
The latest status information provided by the software driver.
Gets or sets the wait time before terminating the attempt to transmit data.
C#
public int TransmitTimeout { get; set; }
Property Value
The time in milliseconds to wait for the connection to transmit.
Exceptions
The value specified is less than zero.
Remarks
The default value of this property is DefaultTimeout.
Gets or sets a value indicating whether a connection break detection is to be used.
C#
public bool UseBreakDetection { get; set; }
Property Value
The value true, if a connection break detection is to be used; otherwise the value false.
Remarks
The default value of this property is false.
Gets or sets a value indicating whether PlcDeviceConnection instances shall use a mechanism to reuse existing channels with the same connection setup.
C#
public static bool UsePool { get; set; }
Property Value
The value true if existing channels shall be reused with the same connection setup; otherwise the value false.
Empties the connection pool.
C#
public static void ClearAllPools()
Remarks
ClearAllPools clears the whole connection pool. If there are connections in use at the time of the call, they are closed.
Empties the connection pool associated with the specified connection
.
C#
public static void ClearPool(PlcDeviceConnection connection)
Parameters
connection
PlcDeviceConnection
The PlcDeviceConnection to be cleared from the pool.
Exceptions
The connection
is a null reference (Nothing in Visual Basic).
Remarks
ClearPool(PlcDeviceConnection) clears the connection pool that is associated with the connection. If additional connections associated with connection are in use at the time of the call, they are closed.
Causes a connection to transition from its current state into the closed state while an established connection to a device will be closed.
C#
public void Close()
Exceptions
The connection is in Faulted state and cannot longer be closed.
The connection has been disposed of.
Closes an established connection to a device.
C#
protected virtual void CloseCore()
Causes a connection to transition from the opened state into the connected state while it does fully establish a connection to a device.
C#
public void Connect()
Exceptions
The connection is not in Opened or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Remarks
In case there is already a connection fully established (see IsConnected) Connect does not perform any connect attempt.
Fully establishes a connection to a device.
C#
protected virtual void ConnectCore()
When implemented in a derived class, creates a new immutable channel which is used as the low level access layer of the connection.
C#
protected abstract PlcDeviceConnectionChannel CreateChannel()
Returns
A new PlcDeviceConnectionChannel configured with the setup of this PlcDeviceConnection and its Device.
Creates a new PlcDataNode which refers to a PlcObject.
C#
protected virtual PlcDataNode CreateNode(PlcObject instance)
Parameters
instance
PlcObject
The PlcObject for that the node is to be created.
Returns
A new PlcDataNode representing the access layer for the PlcObject specified by instance
.
Exceptions
The instance
is a null reference (Nothing in Visual Basic).
Creates a new PlcDataNode which refers to a PlcType.
C#
protected virtual PlcDataNode CreateNode(PlcType type)
Parameters
type
PlcType
The PlcType for that the node is to be created.
Returns
A new PlcDataNode representing the access layer for the PlcType specified by type
.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
Creates a new PlcDataNode which refers to a PlcType and IPlcValue.
C#
protected virtual PlcDataNode CreateNode(PlcType type, IPlcValue value)
Parameters
type
PlcType
The PlcType for that the node is to be created.
value
IPlcValue
The IPlcValue used by the node to represent the type
specific data.
Returns
A new PlcDataNode representing the access layer for the PlcType specified by type
and IPlcValue defined by value
.
Verifies whether the connection is in faulted state.
C#
protected void DenyIfFaulted()
Exceptions
The connection is in faulted state.
Verifies whether the connection has been disposed of.
C#
protected void DenyIfIsDisposed()
Exceptions
The connection has been disposed of.
Verifies whether the connection is in opened, connected or disconnected state.
C#
protected void DenyIfNotReady()
Releases the unmanaged resources used by the PlcDeviceConnection and optionally releases the managed resources.
C#
protected virtual void Dispose(bool disposing)
Parameters
disposing
Boolean
The value true to release both managed and unmanaged resources; otherwise the value false to release only unmanaged resources.
Retrieves the most recent PlcStatus resulted by the most recent read/write action performed using the specified type
.
C#
public PlcStatus GetStatus(PlcType type)
Parameters
type
PlcType
The PlcType its most recent PlcStatus is to be retrieved.
Returns
The PlcStatus of the most recent action performed using the specified type
.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
Raises the Closed event of the PlcDeviceConnection.
C#
protected virtual void OnClosed(EventArgs e)
Parameters
The event data.
Raises the Closing event of the PlcDeviceConnection.
C#
protected virtual void OnClosing(EventArgs e)
Parameters
The event data.
Raises the Connected event of the PlcDeviceConnection.
C#
protected virtual void OnConnected(EventArgs e)
Parameters
The event data.
Raises the Connecting event of the PlcDeviceConnection.
C#
protected virtual void OnConnecting(EventArgs e)
Parameters
The event data.
Raises the Disconnected event of the PlcDeviceConnection.
C#
protected virtual void OnDisconnected(EventArgs e)
Parameters
The event data.
Raises the Faulted event of the PlcDeviceConnection.
C#
protected virtual void OnFaulted(EventArgs e)
Parameters
The event data.
Raises the Opened event of the PlcDeviceConnection.
C#
protected virtual void OnOpened(EventArgs e)
Parameters
The event data.
Raises the Opening event of the PlcDeviceConnection.
C#
protected virtual void OnOpening(EventArgs e)
Parameters
The event data.
Raises the StateChanged event of the PlcDeviceConnection.
C#
protected virtual void OnStateChanged(PlcDeviceConnectionStateChangedEventArgs e)
Parameters
e
PlcDeviceConnectionStateChangedEventArgs
The event data.
Causes a connection to transition from the created or closed state into the opened state while it does establish a connection to a device.
C#
public void Open()
Exceptions
The connection is in Faulted state and cannot longer be opened.
The connection has been disposed of.
Establishes a connection to a device.
C#
protected virtual void OpenCore()
Reads the values associated with the identities
specified.
C#
public IDictionary<PlcIdentity, object> Read(IEnumerable<PlcIdentity> identities)
Parameters
identities
IEnumerable<PlcIdentity>
The PlcIdentity's that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
IDictionary<PlcIdentity, Object>
A dictionary there the PlcIdentity defines the key, while the red value is associated with the key as value.
Exceptions
It is not possible to read data using a relative type (see IsAbsolute).
The identities
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the values associated with the types
specified.
C#
public IDictionary<PlcType, object> Read(IEnumerable<PlcType> types)
Parameters
types
IEnumerable<PlcType>
The PlcType's its values are to be read.
Returns
A dictionary there the PlcType defines the key, while the red value is associated with the key as value.
Exceptions
It is not possible to read data using a relative type (see IsAbsolute).
The types
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the values associated with the identities
specified.
C#
public IDictionary<string, object> Read(IEnumerable<string> identities)
Parameters
identities
IEnumerable<String>
The PlcIdentity's that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
A dictionary there the PlcIdentity defines the key, while the red value is associated with the key as value.
Exceptions
One of the identities
specified is an empty string or it is not possible to read data using a relative type (see IsAbsolute).
The identities
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the values associated with the identities
specified.
C#
public IDictionary<PlcIdentity, object> Read(params PlcIdentity[] identities)
Parameters
identities
PlcIdentity[]
The PlcIdentity's that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
IDictionary<PlcIdentity, Object>
A dictionary there the PlcIdentity defines the key, while the red value is associated with the key as value.
Exceptions
It is not possible to read data using a relative type (see IsAbsolute).
The identities
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the values associated with the types
specified.
C#
public IDictionary<PlcType, object> Read(params PlcType[] types)
Parameters
types
PlcType[]
The PlcType's its values are to be read.
Returns
A dictionary there the PlcType defines the key, while the red value is associated with the key as value.
Exceptions
It is not possible to read data using a relative type (see IsAbsolute).
The types
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the values associated with the identities
specified.
C#
public IDictionary<string, object> Read(params string[] identities)
Parameters
identities
String[]
The PlcIdentity's that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
A dictionary there the PlcIdentity defines the key, while the red value is associated with the key as value.
Exceptions
One of the identities
specified is an empty string or it is not possible to read data using a relative type (see IsAbsolute).
The identities
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Boolean array (in PLC an ARRAY OF BOOL) using the type
specified.
C#
public bool[] ReadBoolean(PlcBooleanArrayType type)
Parameters
type
PlcBooleanArrayType
The PlcBooleanArrayType which addresses the data area to read.
Returns
Boolean[]
The array stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Boolean (in PLC a BOOL) using the type
specified.
C#
public bool ReadBoolean(PlcBooleanType type)
Parameters
type
PlcBooleanType
The PlcBooleanType which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Boolean (in PLC a BOOL) which is associated with the identity
specified.
C#
public bool ReadBoolean(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Bit.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Boolean array (in PLC an ARRAY OF BOOL) which is associated with the identity
specified.
C#
public bool[] ReadBoolean(PlcIdentity identity, int count)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Boolean[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Bit.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Boolean (in PLC a BOOL) which is associated with the identity
specified.
C#
public bool ReadBoolean(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Bit.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Boolean array (in PLC an ARRAY OF BOOL) which is associated with the identity
specified.
C#
public bool[] ReadBoolean(string identity, int count)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Boolean[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Bit.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual bool[] ReadBooleanCore(PlcType type)
Parameters
type
PlcType
The PlcBooleanType or PlcBooleanArrayType to read.
Returns
Boolean[]
An array of the Boolean data read.
Reads a Byte array (in PLC an ARRAY OF BYTE) using the type
specified.
C#
public byte[] ReadByte(PlcByteArrayType type)
Parameters
type
PlcByteArrayType
The PlcByteArrayType which addresses the data area to read.
Returns
Byte[]
The array stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Byte (in PLC a BYTE) using the type
specified.
C#
public byte ReadByte(PlcByteType type)
Parameters
type
PlcByteType
The PlcByteType which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Byte (in PLC a BYTE) which is associated with the identity
specified.
C#
public byte ReadByte(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Byte array (in PLC an ARRAY OF BYTE) which is associated with the identity
specified.
C#
public byte[] ReadByte(PlcIdentity identity, int count)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Byte[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Byte (in PLC a BYTE) which is associated with the identity
specified.
C#
public byte ReadByte(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Byte array (in PLC an ARRAY OF BYTE) which is associated with the identity
specified.
C#
public byte[] ReadByte(string identity, int count)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Byte[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual byte[] ReadByteCore(PlcType type)
Parameters
type
PlcType
The PlcByteType or PlcByteArrayType to read.
Returns
Byte[]
An array of the Byte data read.
Reads a Char array (in PLC an ARRAY OF CHAR) using the type
specified.
C#
public char[] ReadChar(PlcCharArrayType type)
Parameters
type
PlcCharArrayType
The PlcCharArrayType which addresses the data area to read.
Returns
Char[]
The array stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Char (in PLC a CHAR) using the type
specified.
C#
public char ReadChar(PlcCharType type)
Parameters
type
PlcCharType
The PlcCharType which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Char (in PLC a CHAR) which is associated with the identity
specified.
C#
public char ReadChar(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Char array (in PLC an ARRAY OF CHAR) which is associated with the identity
specified.
C#
public char[] ReadChar(PlcIdentity identity, int count)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Char[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Char (in PLC a CHAR) which is associated with the identity
specified.
C#
public char ReadChar(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Char array (in PLC an ARRAY OF CHAR) which is associated with the identity
specified.
C#
public char[] ReadChar(string identity, int count)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Char[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual char[] ReadCharCore(PlcType type)
Parameters
type
PlcType
The PlcCharType or PlcCharArrayType to read.
Returns
Char[]
An array of the Char data read.
Reads the data areas described by the types
specified.
C#
protected virtual IDictionary<PlcType, object> ReadCore(IEnumerable<PlcType> types)
Parameters
types
IEnumerable<PlcType>
The PlcType's to read.
Returns
A dictionary there the PlcType defines the key, while the red value is associated with the key as the value.
Reads the data areas described by the types
specified.
C#
protected virtual IDictionary<PlcType, object> ReadCore(params PlcType[] types)
Parameters
types
PlcType[]
The PlcType's to read.
Returns
A dictionary there the PlcType defines the key, while the red value is associated with the key as the value.
Reads a DateTime (in PLC a DATE) using the type
specified.
C#
public DateTime ReadDate(PlcDateType type)
Parameters
type
PlcDateType
The PlcDateType which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a DateTime (in PLC a DATE) which is associated with the identity
specified.
C#
public DateTime ReadDate(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a DateTime (in PLC a DATE) which is associated with the identity
specified.
C#
public DateTime ReadDate(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual DateTime ReadDateCore(PlcType type)
Parameters
type
PlcType
The PlcDateType to read.
Returns
The DateTime data read.
Reads a DateTime (in PLC a DATE_AND_TIME) using the type
specified.
C#
public DateTime ReadDateTime(PlcDateTimeType type)
Parameters
type
PlcDateTimeType
The PlcDateTimeType which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a DateTime (in PLC a DATE_AND_TIME) which is associated with the identity
specified.
C#
public DateTime ReadDateTime(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a DateTime (in PLC a DATE_AND_TIME) which is associated with the identity
specified.
C#
public DateTime ReadDateTime(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual DateTime ReadDateTimeCore(PlcType type)
Parameters
type
PlcType
The PlcDateTimeType to read.
Returns
The DateTime data read.
Reads a Double array (in PLC an ARRAY OF DOUBLE) using the type
specified.
C#
public double[] ReadDouble(PlcDoubleArrayType type)
Parameters
type
PlcDoubleArrayType
The PlcDoubleArrayType which addresses the data area to read.
Returns
Double[]
The array stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Double (in PLC a DOUBLE) using the type
specified.
C#
public double ReadDouble(PlcDoubleType type)
Parameters
type
PlcDoubleType
The PlcDoubleType which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Double (in PLC a DOUBLE) which is associated with the identity
specified.
C#
public double ReadDouble(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Double array (in PLC an ARRAY OF DOUBLE) which is associated with the identity
specified.
C#
public double[] ReadDouble(PlcIdentity identity, int count)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Double[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Double (in PLC a DOUBLE) which is associated with the identity
specified.
C#
public double ReadDouble(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Double array (in PLC an ARRAY OF DOUBLE) which is associated with the identity
specified.
C#
public double[] ReadDouble(string identity, int count)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Double[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual double[] ReadDoubleCore(PlcType type)
Parameters
type
PlcType
The PlcDoubleType or PlcDoubleArrayType to read.
Returns
Double[]
An array of the Double data read.
Reads the entities
specified.
C#
public IEnumerable<PlcEntityReadResult> ReadEntities(IEnumerable<IPlcEntity> entities)
Parameters
entities
IEnumerable<IPlcEntity>
The IPlcEntity's to read.
Returns
IEnumerable<PlcEntityReadResult>
A sequence of PlcEntityReadResult instances containing the IPlcEntity and its resulting data after a read operation has been performed for the entity.
Exceptions
It is not possible to read data using a relative type (see IsAbsolute).
The entities
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the entities
specified.
C#
public IEnumerable<PlcEntityReadResult> ReadEntities(params IPlcEntity[] entities)
Parameters
entities
IPlcEntity[]
The IPlcEntity's to read.
Returns
IEnumerable<PlcEntityReadResult>
A sequence of PlcEntityReadResult instances containing the IPlcEntity and its resulting data after a read operation has been performed for the entity.
Exceptions
It is not possible to read data using a relative type (see IsAbsolute).
The entities
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int16 (in PLC a INT) which is associated with the identity
specified.
C#
public short ReadInt16(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int16 array (in PLC an ARRAY OF INT) which is associated with the identity
specified.
C#
public short[] ReadInt16(PlcIdentity identity, int count)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Int16[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int16 array (in PLC an ARRAY OF INT) using the type
specified.
C#
public short[] ReadInt16(PlcInt16ArrayType type)
Parameters
type
PlcInt16ArrayType
The PlcInt16ArrayType which addresses the data area to read.
Returns
Int16[]
The array stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int16 (in PLC a INT) using the type
specified.
C#
public short ReadInt16(PlcInt16Type type)
Parameters
type
PlcInt16Type
The PlcInt16Type which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int16 (in PLC a INT) which is associated with the identity
specified.
C#
public short ReadInt16(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int16 array (in PLC an ARRAY OF INT) which is associated with the identity
specified.
C#
public short[] ReadInt16(string identity, int count)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Int16[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual short[] ReadInt16Core(PlcType type)
Parameters
type
PlcType
The PlcInt16Type or PlcInt16ArrayType to read.
Returns
Int16[]
An array of the Int16 data read.
Reads a Int32 (in PLC a DINT) which is associated with the identity
specified.
C#
public int ReadInt32(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int32 array (in PLC an ARRAY OF DINT) which is associated with the identity
specified.
C#
public int[] ReadInt32(PlcIdentity identity, int count)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Int32[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int32 array (in PLC an ARRAY OF DINT) using the type
specified.
C#
public int[] ReadInt32(PlcInt32ArrayType type)
Parameters
type
PlcInt32ArrayType
The PlcInt32ArrayType which addresses the data area to read.
Returns
Int32[]
The array stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int32 (in PLC a DINT) using the type
specified.
C#
public int ReadInt32(PlcInt32Type type)
Parameters
type
PlcInt32Type
The PlcInt32Type which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int32 (in PLC a DINT) which is associated with the identity
specified.
C#
public int ReadInt32(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int32 array (in PLC an ARRAY OF DINT) which is associated with the identity
specified.
C#
public int[] ReadInt32(string identity, int count)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Int32[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual int[] ReadInt32Core(PlcType type)
Parameters
type
PlcType
The PlcInt32Type or PlcInt32ArrayType to read.
Returns
Int32[]
An array of the Int32 data read.
Reads a Int64 (in PLC a DINT) which is associated with the identity
specified.
C#
public long ReadInt64(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int64 array (in PLC an ARRAY OF DINT) which is associated with the identity
specified.
C#
public long[] ReadInt64(PlcIdentity identity, int count)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Int64[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int64 array (in PLC an ARRAY OF DINT) using the type
specified.
C#
public long[] ReadInt64(PlcInt64ArrayType type)
Parameters
type
PlcInt64ArrayType
The PlcInt64ArrayType which addresses the data area to read.
Returns
Int64[]
The array stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int64 (in PLC a DINT) using the type
specified.
C#
public long ReadInt64(PlcInt64Type type)
Parameters
type
PlcInt64Type
The PlcInt64Type which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int64 (in PLC a DINT) which is associated with the identity
specified.
C#
public long ReadInt64(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Int64 array (in PLC an ARRAY OF DINT) which is associated with the identity
specified.
C#
public long[] ReadInt64(string identity, int count)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Int64[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual long[] ReadInt64Core(PlcType type)
Parameters
type
PlcType
The PlcInt64Type or PlcInt64ArrayType to read.
Returns
Int64[]
An array of the Int64 data read.
Reads a Double (in PLC a LREAL) which is associated with the identity
specified.
C#
public double ReadLReal(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Double array (in PLC an ARRAY OF LREAL) which is associated with the identity
specified.
C#
public double[] ReadLReal(PlcIdentity identity, int count)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Double[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Double array (in PLC an ARRAY OF LREAL) using the type
specified.
C#
public double[] ReadLReal(PlcLRealArrayType type)
Parameters
type
PlcLRealArrayType
The PlcLRealArrayType which addresses the data area to read.
Returns
Double[]
The array stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Double (in PLC a LREAL) using the type
specified.
C#
public double ReadLReal(PlcLRealType type)
Parameters
type
PlcLRealType
The PlcLRealType which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Double (in PLC a LREAL) which is associated with the identity
specified.
C#
public double ReadLReal(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Double array (in PLC an ARRAY OF LREAL) which is associated with the identity
specified.
C#
public double[] ReadLReal(string identity, int count)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Double[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual double[] ReadLRealCore(PlcType type)
Parameters
type
PlcType
The PlcLRealType or PlcLRealArrayType to read.
Returns
Double[]
An array of the Double data read.
Reads the data area described by the node
specified.
C#
protected virtual object ReadNodeCore(PlcDataNode node)
Parameters
node
PlcDataNode
The PlcDataNode to read.
Returns
The data read.
When implemented in a derived class, reads the data areas described by the nodes
specified.
C#
protected abstract IEnumerable<object> ReadNodesCore(IEnumerable<PlcDataNode> nodes)
Parameters
nodes
IEnumerable<PlcDataNode>
The PlcDataNode's to read.
Returns
The sequence of data read.
Reads the data areas described by the nodes
specified.
C#
protected IEnumerable<object> ReadNodesCore(params PlcDataNode[] nodes)
Parameters
nodes
PlcDataNode[]
The PlcDataNode's to read.
Returns
The sequence of data read.
Reads a PlcObject (in PLC a STRUCT) which is associated with the identity
specified.
C#
public PlcObject ReadObject(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a PlcObject (in PLC a STRUCT) using the type
specified.
C#
public PlcObject ReadObject(PlcObjectType type)
Parameters
type
PlcObjectType
The PlcObjectType which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a PlcObject (in PLC a STRUCT) which is associated with the identity
specified.
C#
public PlcObject ReadObject(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the PlcObject specified by T
.
C#
public T ReadObject<T>() where T : PlcObject, new()
Returns
A new instance of the PlcObject type specified by T
initialized with the values stored in the PLC.
Exceptions
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the PlcObject specified by T
using the instance
passed.
C#
public T ReadObject<T>(T instance) where T : PlcObject
Parameters
instance
T
The instance of T
to read.
Returns
The instance
its Members where read from the PLC.
Exceptions
The instance
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Single (in PLC a REAL) which is associated with the identity
specified.
C#
public float ReadReal(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Single array (in PLC an ARRAY OF REAL) which is associated with the identity
specified.
C#
public float[] ReadReal(PlcIdentity identity, int count)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Single[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Single array (in PLC an ARRAY OF REAL) using the type
specified.
C#
public float[] ReadReal(PlcRealArrayType type)
Parameters
type
PlcRealArrayType
The PlcRealArrayType which addresses the data area to read.
Returns
Single[]
The array stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Single (in PLC a REAL) using the type
specified.
C#
public float ReadReal(PlcRealType type)
Parameters
type
PlcRealType
The PlcRealType which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Single (in PLC a REAL) which is associated with the identity
specified.
C#
public float ReadReal(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a Single array (in PLC an ARRAY OF REAL) which is associated with the identity
specified.
C#
public float[] ReadReal(string identity, int count)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
Single[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual float[] ReadRealCore(PlcType type)
Parameters
type
PlcType
The PlcRealType or PlcRealArrayType to read.
Returns
Single[]
An array of the Single data read.
Reads a TimeSpan (in PLC a S5TIME) which is associated with the identity
specified.
C#
public TimeSpan ReadS5Time(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a TimeSpan (in PLC a S5TIME) using the type
specified.
C#
public TimeSpan ReadS5Time(PlcS5TimeType type)
Parameters
type
PlcS5TimeType
The PlcS5TimeType which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a TimeSpan (in PLC a S5TIME) which is associated with the identity
specified.
C#
public TimeSpan ReadS5Time(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual TimeSpan ReadS5TimeCore(PlcType type)
Parameters
type
PlcType
The PlcS5TimeType to read.
Returns
The TimeSpan data read.
Reads a String (in PLC a STRING) which is associated with the identity
specified.
C#
public string ReadString(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a String (in PLC a STRING) which is associated with the identity
specified.
C#
public string ReadString(PlcIdentity identity, int length)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
length
Int32
The number of characters to read.
Returns
The String stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The length
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a String (in PLC a STRING) using the type
specified.
C#
public string ReadString(PlcStringType type)
Parameters
type
PlcStringType
The PlcStringType which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a String (in PLC a STRING) which is associated with the identity
specified.
C#
public string ReadString(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a String (in PLC a STRING) which is associated with the identity
specified.
C#
public string ReadString(string identity, int length)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
length
Int32
The number of characters to read.
Returns
The String stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The length
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual string ReadStringCore(PlcType type)
Parameters
type
PlcType
The PlcStringType to read.
Returns
The String data read.
Reads a TimeSpan (in PLC a TIME_OF_DAY) which is associated with the identity
specified.
C#
public TimeSpan ReadTime(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a TimeSpan (in PLC a TIME_OF_DAY) using the type
specified.
C#
public TimeSpan ReadTime(PlcTimeType type)
Parameters
type
PlcTimeType
The PlcTimeType which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a TimeSpan (in PLC a TIME_OF_DAY) which is associated with the identity
specified.
C#
public TimeSpan ReadTime(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual TimeSpan ReadTimeCore(PlcType type)
Parameters
type
PlcType
The PlcTimeType to read.
Returns
The TimeSpan data read.
Reads a TimeSpan (in PLC a TIME_OF_DAY) which is associated with the identity
specified.
C#
public TimeSpan ReadTimeOfDay(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a TimeSpan (in PLC a TIME_OF_DAY) using the type
specified.
C#
public TimeSpan ReadTimeOfDay(PlcTimeOfDayType type)
Parameters
type
PlcTimeOfDayType
The PlcTimeOfDayType which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a TimeSpan (in PLC a TIME_OF_DAY) which is associated with the identity
specified.
C#
public TimeSpan ReadTimeOfDay(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual TimeSpan ReadTimeOfDayCore(PlcType type)
Parameters
type
PlcType
The PlcTimeOfDayType to read.
Returns
The TimeSpan data read.
Reads a UInt16 (in PLC a WORD) which is associated with the identity
specified.
C#
[CLSCompliant(false)] public ushort ReadUInt16(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a UInt16 array (in PLC an ARRAY OF WORD) which is associated with the identity
specified.
C#
[CLSCompliant(false)] public ushort[] ReadUInt16(PlcIdentity identity, int count)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
UInt16[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a UInt16 array (in PLC an ARRAY OF WORD) using the type
specified.
C#
[CLSCompliant(false)] public ushort[] ReadUInt16(PlcUInt16ArrayType type)
Parameters
type
PlcUInt16ArrayType
The PlcUInt16ArrayType which addresses the data area to read.
Returns
UInt16[]
The array stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a UInt16 (in PLC a WORD) using the type
specified.
C#
[CLSCompliant(false)] public ushort ReadUInt16(PlcUInt16Type type)
Parameters
type
PlcUInt16Type
The PlcUInt16Type which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a UInt16 (in PLC a WORD) which is associated with the identity
specified.
C#
[CLSCompliant(false)] public ushort ReadUInt16(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a UInt16 array (in PLC an ARRAY OF WORD) which is associated with the identity
specified.
C#
[CLSCompliant(false)] public ushort[] ReadUInt16(string identity, int count)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
UInt16[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
[CLSCompliant(false)] protected virtual ushort[] ReadUInt16Core(PlcType type)
Parameters
type
PlcType
The PlcUInt16Type or PlcUInt16ArrayType to read.
Returns
UInt16[]
An array of the UInt16 data read.
Reads a UInt32 (in PLC a DWORD) which is associated with the identity
specified.
C#
[CLSCompliant(false)] public uint ReadUInt32(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a UInt32 array (in PLC an ARRAY OF DWORD) which is associated with the identity
specified.
C#
[CLSCompliant(false)] public uint[] ReadUInt32(PlcIdentity identity, int count)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
UInt32[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a UInt32 array (in PLC an ARRAY OF DWORD) using the type
specified.
C#
[CLSCompliant(false)] public uint[] ReadUInt32(PlcUInt32ArrayType type)
Parameters
type
PlcUInt32ArrayType
The PlcUInt32ArrayType which addresses the data area to read.
Returns
UInt32[]
The array stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a UInt32 (in PLC a DWORD) using the type
specified.
C#
[CLSCompliant(false)] public uint ReadUInt32(PlcUInt32Type type)
Parameters
type
PlcUInt32Type
The PlcUInt32Type which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a UInt32 (in PLC a DWORD) which is associated with the identity
specified.
C#
[CLSCompliant(false)] public uint ReadUInt32(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a UInt32 array (in PLC an ARRAY OF DWORD) which is associated with the identity
specified.
C#
[CLSCompliant(false)] public uint[] ReadUInt32(string identity, int count)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
UInt32[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
[CLSCompliant(false)] protected virtual uint[] ReadUInt32Core(PlcType type)
Parameters
type
PlcType
The PlcUInt32Type or PlcUInt32ArrayType to read.
Returns
UInt32[]
An array of the UInt32 data read.
Reads a UInt64 (in PLC a LWORD) which is associated with the identity
specified.
C#
[CLSCompliant(false)] public ulong ReadUInt64(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a UInt64 array (in PLC an ARRAY OF LWORD) which is associated with the identity
specified.
C#
[CLSCompliant(false)] public ulong[] ReadUInt64(PlcIdentity identity, int count)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
UInt64[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a UInt64 array (in PLC an ARRAY OF LWORD) using the type
specified.
C#
[CLSCompliant(false)] public ulong[] ReadUInt64(PlcUInt64ArrayType type)
Parameters
type
PlcUInt64ArrayType
The PlcUInt64ArrayType which addresses the data area to read.
Returns
UInt64[]
The array stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a UInt64 (in PLC a LWORD) using the type
specified.
C#
[CLSCompliant(false)] public ulong ReadUInt64(PlcUInt64Type type)
Parameters
type
PlcUInt64Type
The PlcUInt64Type which addresses the data area to read.
Returns
The value stored at the data area described by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a UInt64 (in PLC a LWORD) which is associated with the identity
specified.
C#
[CLSCompliant(false)] public ulong ReadUInt64(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads a UInt64 array (in PLC an ARRAY OF LWORD) which is associated with the identity
specified.
C#
[CLSCompliant(false)] public ulong[] ReadUInt64(string identity, int count)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
UInt64[]
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
[CLSCompliant(false)] protected virtual ulong[] ReadUInt64Core(PlcType type)
Parameters
type
PlcType
The PlcUInt64Type or PlcUInt64ArrayType to read.
Returns
UInt64[]
An array of the UInt64 data read.
Reads the specified value
.
C#
public T ReadValue<T>(IPlcValue<T> value)
Parameters
The IPlcValue´1 to read.
Returns
The framework value of the value specified.
Exceptions
The value
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the T
which is associated with the identity
specified.
C#
public T ReadValue<T>(PlcIdentity identity)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The metadata specified could not be resolved to a valid PlcValueType or the identity
does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads an array of the T
which is associated with the identity
specified.
C#
public T[] ReadValue<T>(PlcIdentity identity, int count) where T : new()
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
The array stored at the data area identified by the identity
specified.
Exceptions
The metadata specified could not be resolved to a valid PlcArrayType or the identity
does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the T
which is associated with the identity
specified.
C#
public T ReadValue<T>(string identity)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
The value stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads an array of the T
which is associated with the identity
specified.
C#
public T[] ReadValue<T>(string identity, int count) where T : new()
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data area described by the type
specified.
C#
protected virtual T[] ReadValueCore<T>(PlcArrayType type)
Parameters
type
PlcArrayType
The PlcArrayType to read.
Returns
The T
array data read.
Reads the data area described by the type
specified.
C#
protected virtual T ReadValueCore<T>(PlcValueType type)
Parameters
type
PlcValueType
The PlcValueType to read.
Returns
The T
value data read.
Reads the values specified.
C#
public object[] ReadValues(IEnumerable<IPlcValue> values)
Parameters
values
IEnumerable<IPlcValue>
The IPlcValue objects to read.
Returns
Object[]
An array of framework values of the values specified.
Exceptions
The values
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the values associated with the identities
specified.
C#
public object[] ReadValues(IEnumerable<PlcIdentity> identities)
Parameters
identities
IEnumerable<PlcIdentity>
The PlcIdentity's that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
Object[]
An array of the values red.
Exceptions
It is not possible to read data using a relative type (see IsAbsolute).
The identities
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the values associated with the types
specified.
C#
public object[] ReadValues(IEnumerable<PlcType> types)
Parameters
types
IEnumerable<PlcType>
The PlcType's its values are to be read.
Returns
Object[]
An array of the values red.
Exceptions
It is not possible to read data using a relative type (see IsAbsolute).
The types
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the values associated with the identities
specified.
C#
public object[] ReadValues(IEnumerable<string> identities)
Parameters
identities
IEnumerable<String>
The PlcIdentity's that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
Object[]
An array of the values red.
Exceptions
One of the identities
specified is an empty string or it is not possible to read data using a relative type (see IsAbsolute).
The identities
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the values specified.
C#
public object[] ReadValues(params IPlcValue[] values)
Parameters
values
IPlcValue[]
The IPlcValue objects to read.
Returns
Object[]
An array of framework values of the values specified.
Exceptions
The values
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the values associated with the identities
specified.
C#
public object[] ReadValues(params PlcIdentity[] identities)
Parameters
identities
PlcIdentity[]
The PlcIdentity's that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
Object[]
An array of the values red.
Exceptions
It is not possible to read data using a relative type (see IsAbsolute).
The identities
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the values associated with the types
specified.
C#
public object[] ReadValues(params PlcType[] types)
Parameters
types
PlcType[]
The PlcType's its values are to be read.
Returns
Object[]
An array of the values red.
Exceptions
It is not possible to read data using a relative type (see IsAbsolute).
The types
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the values associated with the identities
specified.
C#
public object[] ReadValues(params string[] identities)
Parameters
identities
String[]
The PlcIdentity's that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
Returns
Object[]
An array of the values red.
Exceptions
One of the identities
specified is an empty string or it is not possible to read data using a relative type (see IsAbsolute).
The identities
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the values specified.
C#
public T[] ReadValues<T>(IEnumerable<IPlcValue<T>> values)
Parameters
values
IEnumerable<IPlcValue>
The IPlcValue´1 objects to read.
Returns
An array of framework values of the values specified.
Exceptions
The values
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the values specified.
C#
public T[] ReadValues<T>(params IPlcValue<T>[] values)
Parameters
The IPlcValue´1 objects to read.
Returns
An array of framework values of the values specified.
Exceptions
The values
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads an array of the T
which is associated with the identity
specified.
C#
public T[] ReadValues<T>(PlcIdentity identity, int count)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads an array of the T
which is associated with the identity
specified.
C#
public T[] ReadValues<T>(string identity, int count)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to read) associated with the Device of this connection.
count
Int32
The number of items to read.
Returns
The array stored at the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The count
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Reads the data areas described by the values
specified.
C#
protected virtual object[] ReadValuesCore(IEnumerable<IPlcValue> values)
Parameters
values
IEnumerable<IPlcValue>
The IPlcValue's to read.
Returns
Object[]
An array of objects read.
Reads the data area described by the type
specified.
C#
protected virtual T[] ReadValuesCore<T>(PlcArrayType type)
Parameters
type
PlcArrayType
The PlcArrayType to read.
Returns
The T
array data read.
Writes the values associated with the PlcIdentity objects in the identityValues
specified.
C#
public void Write(IEnumerable<KeyValuePair<PlcIdentity, object>> identityValues)
Parameters
identityValues
IEnumerable<KeyValuePair>
The PlcIdentity's that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection. While the PlcIdentity represents the key in the pair the value of the identity to write is stored as the value in the pair.
Exceptions
It is not possible to write data using a relative type (see IsAbsolute).
The identityValues
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the values associated with the PlcType objects in the typeValues
specified.
C#
public void Write(IEnumerable<KeyValuePair<PlcType, object>> typeValues)
Parameters
typeValues
IEnumerable<KeyValuePair>
The PlcType's its values are to be written. While the PlcType represents the key in the pair the value of the type to write is stored as the value in the pair.
Exceptions
It is not possible to write data using a relative type (see IsAbsolute).
The typeValues
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the values associated with the identities in the identityValues
specified.
C#
public void Write(IEnumerable<KeyValuePair<string, object>> identityValues)
Parameters
identityValues
IEnumerable<KeyValuePair>
The PlcIdentity's that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection. While the PlcIdentity represents the key in the pair the value of the identity to write is stored as the value in the pair.
Exceptions
One of the identityValues
specified is an empty string or it is not possible to write data using a relative type (see IsAbsolute).
The identityValues
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the values associated with the PlcIdentity objects in the identityValues
specified.
C#
public void Write(params KeyValuePair<PlcIdentity, object>[] identityValues)
Parameters
identityValues
KeyValuePair<PlcIdentity, Object>[]
The PlcIdentity's that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection. While the PlcIdentity represents the key in the pair the value of the identity to write is stored as the value in the pair.
Exceptions
It is not possible to write data using a relative type (see IsAbsolute).
The identityValues
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the values associated with the PlcType objects in the typeValues
specified.
C#
public void Write(params KeyValuePair<PlcType, object>[] typeValues)
Parameters
typeValues
KeyValuePair<PlcType, Object>[]
The PlcType's its values are to be written. While the PlcType represents the key in the pair the value of the type to write is stored as the value in the pair.
Exceptions
It is not possible to write data using a relative type (see IsAbsolute).
The typeValues
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the values associated with the identities in the identityValues
specified.
C#
public void Write(params KeyValuePair<string, object>[] identityValues)
Parameters
identityValues
KeyValuePair<String, Object>[]
The PlcIdentity's that can be either a PlcAddress which addresses the data area to read. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection. While the PlcIdentity represents the key in the pair the value of the identity to write is stored as the value in the pair.
Exceptions
One of the identityValues
specified is an empty string or it is not possible to write data using a relative type (see IsAbsolute).
The identityValues
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Boolean array (in PLC an ARRAY OF BOOL) values
to the data area associated with the type
specified.
C#
public void WriteBoolean(PlcBooleanArrayType type, params bool[] values)
Parameters
type
PlcBooleanArrayType
The PlcBooleanArrayType which addresses the data area to write.
values
Boolean[]
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Boolean array (in PLC an ARRAY OF BOOL) values
to the data area associated with the type
specified.
C#
public void WriteBoolean(PlcBooleanArrayType type, IEnumerable<bool> values)
Parameters
type
PlcBooleanArrayType
The PlcBooleanArrayType which addresses the data area to write.
values
IEnumerable<Boolean>
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Boolean (in PLC a BOOL) value
using the type
specified.
C#
public void WriteBoolean(PlcBooleanType type, bool value)
Parameters
type
PlcBooleanType
The PlcBooleanType which addresses the data area to write.
value
Boolean
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Boolean (in PLC a BOOL) value
to the data area associated with the identity
specified.
C#
public void WriteBoolean(PlcIdentity identity, bool value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Boolean
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Bit.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Boolean array (in PLC an ARRAY OF BOOL) values
to the data area associated with the identity
specified.
C#
public void WriteBoolean(PlcIdentity identity, params bool[] values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Boolean[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Bit.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Boolean array (in PLC an ARRAY OF BOOL) values
to the data area associated with the identity
specified.
C#
public void WriteBoolean(PlcIdentity identity, IEnumerable<bool> values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Boolean>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Bit.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Boolean (in PLC a BOOL) value
to the data area associated with the identity
specified.
C#
public void WriteBoolean(string identity, bool value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Boolean
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Bit.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Boolean array (in PLC an ARRAY OF BOOL) values
to the data area associated with the identity
specified.
C#
public void WriteBoolean(string identity, params bool[] values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Boolean[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Bit.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Boolean array (in PLC an ARRAY OF BOOL) values
to the data area associated with the identity
specified.
C#
public void WriteBoolean(string identity, IEnumerable<bool> values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Boolean>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Bit.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteBooleanCore(PlcType type, params bool[] values)
Parameters
type
PlcType
The PlcBooleanType or PlcBooleanArrayType to write.
values
Boolean[]
The array of Boolean data to write.
Writes the Byte array (in PLC an ARRAY OF BYTE) values
to the data area associated with the type
specified.
C#
public void WriteByte(PlcByteArrayType type, params byte[] values)
Parameters
type
PlcByteArrayType
The PlcByteArrayType which addresses the data area to write.
values
Byte[]
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Byte array (in PLC an ARRAY OF BYTE) values
to the data area associated with the type
specified.
C#
public void WriteByte(PlcByteArrayType type, IEnumerable<byte> values)
Parameters
type
PlcByteArrayType
The PlcByteArrayType which addresses the data area to write.
values
IEnumerable<Byte>
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Byte (in PLC a BYTE) value
using the type
specified.
C#
public void WriteByte(PlcByteType type, byte value)
Parameters
type
PlcByteType
The PlcByteType which addresses the data area to write.
value
Byte
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Byte (in PLC a BYTE) value
to the data area associated with the identity
specified.
C#
public void WriteByte(PlcIdentity identity, byte value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Byte
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Byte array (in PLC an ARRAY OF BYTE) values
to the data area associated with the identity
specified.
C#
public void WriteByte(PlcIdentity identity, params byte[] values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Byte[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Byte array (in PLC an ARRAY OF BYTE) values
to the data area associated with the identity
specified.
C#
public void WriteByte(PlcIdentity identity, IEnumerable<byte> values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Byte>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Byte (in PLC a BYTE) value
to the data area associated with the identity
specified.
C#
public void WriteByte(string identity, byte value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Byte
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Byte array (in PLC an ARRAY OF BYTE) values
to the data area associated with the identity
specified.
C#
public void WriteByte(string identity, params byte[] values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Byte[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Byte array (in PLC an ARRAY OF BYTE) values
to the data area associated with the identity
specified.
C#
public void WriteByte(string identity, IEnumerable<byte> values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Byte>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteByteCore(PlcType type, params byte[] values)
Parameters
type
PlcType
The PlcByteType or PlcByteArrayType to write.
values
Byte[]
The array of Byte data to write.
Writes the Char array (in PLC an ARRAY OF CHAR) values
to the data area associated with the type
specified.
C#
public void WriteChar(PlcCharArrayType type, params char[] values)
Parameters
type
PlcCharArrayType
The PlcCharArrayType which addresses the data area to write.
values
Char[]
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Char array (in PLC an ARRAY OF CHAR) values
to the data area associated with the type
specified.
C#
public void WriteChar(PlcCharArrayType type, IEnumerable<char> values)
Parameters
type
PlcCharArrayType
The PlcCharArrayType which addresses the data area to write.
values
IEnumerable<Char>
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Char (in PLC a CHAR) value
using the type
specified.
C#
public void WriteChar(PlcCharType type, char value)
Parameters
type
PlcCharType
The PlcCharType which addresses the data area to write.
value
Char
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Char (in PLC a CHAR) value
to the data area associated with the identity
specified.
C#
public void WriteChar(PlcIdentity identity, char value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Char
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Char array (in PLC an ARRAY OF CHAR) values
to the data area associated with the identity
specified.
C#
public void WriteChar(PlcIdentity identity, params char[] values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Char[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Char array (in PLC an ARRAY OF CHAR) values
to the data area associated with the identity
specified.
C#
public void WriteChar(PlcIdentity identity, IEnumerable<char> values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Char>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Char (in PLC a CHAR) value
to the data area associated with the identity
specified.
C#
public void WriteChar(string identity, char value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Char
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Char array (in PLC an ARRAY OF CHAR) values
to the data area associated with the identity
specified.
C#
public void WriteChar(string identity, params char[] values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Char[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Char array (in PLC an ARRAY OF CHAR) values
to the data area associated with the identity
specified.
C#
public void WriteChar(string identity, IEnumerable<char> values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Char>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteCharCore(PlcType type, params char[] values)
Parameters
type
PlcType
The PlcCharType or PlcCharArrayType to write.
values
Char[]
The array of Char data to write.
Writes the values associated with the PlcType objects in the typeValues
specified.
C#
protected virtual void WriteCore(IEnumerable<KeyValuePair<PlcType, object>> typeValues)
Parameters
typeValues
IEnumerable<KeyValuePair>
The PlcType's its values are to be written. While the PlcType represents the key in the pair the value of the type to write is stored as the value in the pair.
Writes the DateTime (in PLC a DATE) value
using the type
specified.
C#
public void WriteDate(PlcDateType type, DateTime value)
Parameters
type
PlcDateType
The PlcDateType which addresses the data area to write.
value
DateTime
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the DateTime (in PLC a DATE) value
to the data area associated with the identity
specified.
C#
public void WriteDate(PlcIdentity identity, DateTime value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
DateTime
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the DateTime (in PLC a DATE) value
to the data area associated with the identity
specified.
C#
public void WriteDate(string identity, DateTime value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
DateTime
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteDateCore(PlcType type, DateTime value)
Parameters
type
PlcType
The PlcDateType to write.
value
DateTime
The DateTime data to write.
Writes the DateTime (in PLC a DATE_AND_TIME) value
using the type
specified.
C#
public void WriteDateTime(PlcDateTimeType type, DateTime value)
Parameters
type
PlcDateTimeType
The PlcDateTimeType which addresses the data area to write.
value
DateTime
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the DateTime (in PLC a DATE_AND_TIME) value
to the data area associated with the identity
specified.
C#
public void WriteDateTime(PlcIdentity identity, DateTime value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
DateTime
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the DateTime (in PLC a DATE_AND_TIME) value
to the data area associated with the identity
specified.
C#
public void WriteDateTime(string identity, DateTime value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
DateTime
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteDateTimeCore(PlcType type, DateTime value)
Parameters
type
PlcType
The PlcDateTimeType to write.
value
DateTime
The DateTime data to write.
Writes the Double array (in PLC an ARRAY OF DOUBLE) values
to the data area associated with the type
specified.
C#
public void WriteDouble(PlcDoubleArrayType type, params double[] values)
Parameters
type
PlcDoubleArrayType
The PlcDoubleArrayType which addresses the data area to write.
values
Double[]
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double array (in PLC an ARRAY OF DOUBLE) values
to the data area associated with the type
specified.
C#
public void WriteDouble(PlcDoubleArrayType type, IEnumerable<double> values)
Parameters
type
PlcDoubleArrayType
The PlcDoubleArrayType which addresses the data area to write.
values
IEnumerable<Double>
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double (in PLC a DOUBLE) value
using the type
specified.
C#
public void WriteDouble(PlcDoubleType type, double value)
Parameters
type
PlcDoubleType
The PlcDoubleType which addresses the data area to write.
value
Double
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double (in PLC a DOUBLE) value
to the data area associated with the identity
specified.
C#
public void WriteDouble(PlcIdentity identity, double value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Double
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double array (in PLC an ARRAY OF DOUBLE) values
to the data area associated with the identity
specified.
C#
public void WriteDouble(PlcIdentity identity, params double[] values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Double[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double array (in PLC an ARRAY OF DOUBLE) values
to the data area associated with the identity
specified.
C#
public void WriteDouble(PlcIdentity identity, IEnumerable<double> values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Double>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double (in PLC a DOUBLE) value
to the data area associated with the identity
specified.
C#
public void WriteDouble(string identity, double value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Double
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double array (in PLC an ARRAY OF DOUBLE) values
to the data area associated with the identity
specified.
C#
public void WriteDouble(string identity, params double[] values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Double[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double array (in PLC an ARRAY OF DOUBLE) values
to the data area associated with the identity
specified.
C#
public void WriteDouble(string identity, IEnumerable<double> values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Double>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteDoubleCore(PlcType type, params double[] values)
Parameters
type
PlcType
The PlcDoubleType or PlcDoubleArrayType to write.
values
Double[]
The array of Double data to write.
Writes the entities
specified.
C#
public IEnumerable<PlcEntityWriteResult> WriteEntities(IEnumerable<IPlcEntity> entities)
Parameters
entities
IEnumerable<IPlcEntity>
The IPlcEntity's to write.
Returns
IEnumerable<PlcEntityWriteResult>
A sequence of PlcEntityWriteResult instances containing the IPlcEntity and its resulting data after a write operation has been performed for the entity.
Exceptions
It is not possible to write data using a relative type (see IsAbsolute).
The entities
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Remarks
In case there a PlcType is passed as an IPlcEntity the default value of the PlcType is written.
Writes the entities
specified.
C#
public IEnumerable<PlcEntityWriteResult> WriteEntities(params IPlcEntity[] entities)
Parameters
entities
IPlcEntity[]
The IPlcEntity's to write.
Returns
IEnumerable<PlcEntityWriteResult>
A sequence of PlcEntityWriteResult instances containing the IPlcEntity and its resulting data after a write operation has been performed for the entity.
Exceptions
It is not possible to write data using a relative type (see IsAbsolute).
The entities
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Remarks
In case there a PlcType is passed as an IPlcEntity the default value of the PlcType is written.
Writes the Int16 array (in PLC an ARRAY OF INT) values
to the data area associated with the identity
specified.
C#
public void WriteInt16(PlcIdentity identity, IEnumerable<short> values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Int16>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int16 (in PLC a INT) value
to the data area associated with the identity
specified.
C#
public void WriteInt16(PlcIdentity identity, short value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Int16
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int16 array (in PLC an ARRAY OF INT) values
to the data area associated with the identity
specified.
C#
public void WriteInt16(PlcIdentity identity, params short[] values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Int16[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int16 array (in PLC an ARRAY OF INT) values
to the data area associated with the type
specified.
C#
public void WriteInt16(PlcInt16ArrayType type, IEnumerable<short> values)
Parameters
type
PlcInt16ArrayType
The PlcInt16ArrayType which addresses the data area to write.
values
IEnumerable<Int16>
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int16 array (in PLC an ARRAY OF INT) values
to the data area associated with the type
specified.
C#
public void WriteInt16(PlcInt16ArrayType type, params short[] values)
Parameters
type
PlcInt16ArrayType
The PlcInt16ArrayType which addresses the data area to write.
values
Int16[]
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int16 (in PLC a INT) value
using the type
specified.
C#
public void WriteInt16(PlcInt16Type type, short value)
Parameters
type
PlcInt16Type
The PlcInt16Type which addresses the data area to write.
value
Int16
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int16 array (in PLC an ARRAY OF INT) values
to the data area associated with the identity
specified.
C#
public void WriteInt16(string identity, IEnumerable<short> values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Int16>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int16 (in PLC a INT) value
to the data area associated with the identity
specified.
C#
public void WriteInt16(string identity, short value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Int16
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int16 array (in PLC an ARRAY OF INT) values
to the data area associated with the identity
specified.
C#
public void WriteInt16(string identity, params short[] values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Int16[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteInt16Core(PlcType type, params short[] values)
Parameters
type
PlcType
The PlcInt16Type or PlcInt16ArrayType to write.
values
Int16[]
The array of Int16 data to write.
Writes the Int32 array (in PLC an ARRAY OF DINT) values
to the data area associated with the identity
specified.
C#
public void WriteInt32(PlcIdentity identity, IEnumerable<int> values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Int32>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int32 (in PLC a DINT) value
to the data area associated with the identity
specified.
C#
public void WriteInt32(PlcIdentity identity, int value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Int32
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int32 array (in PLC an ARRAY OF DINT) values
to the data area associated with the identity
specified.
C#
public void WriteInt32(PlcIdentity identity, params int[] values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Int32[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int32 array (in PLC an ARRAY OF DINT) values
to the data area associated with the type
specified.
C#
public void WriteInt32(PlcInt32ArrayType type, IEnumerable<int> values)
Parameters
type
PlcInt32ArrayType
The PlcInt32ArrayType which addresses the data area to write.
values
IEnumerable<Int32>
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int32 array (in PLC an ARRAY OF DINT) values
to the data area associated with the type
specified.
C#
public void WriteInt32(PlcInt32ArrayType type, params int[] values)
Parameters
type
PlcInt32ArrayType
The PlcInt32ArrayType which addresses the data area to write.
values
Int32[]
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int32 (in PLC a DINT) value
using the type
specified.
C#
public void WriteInt32(PlcInt32Type type, int value)
Parameters
type
PlcInt32Type
The PlcInt32Type which addresses the data area to write.
value
Int32
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int32 array (in PLC an ARRAY OF DINT) values
to the data area associated with the identity
specified.
C#
public void WriteInt32(string identity, IEnumerable<int> values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Int32>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int32 (in PLC a DINT) value
to the data area associated with the identity
specified.
C#
public void WriteInt32(string identity, int value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Int32
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int32 array (in PLC an ARRAY OF DINT) values
to the data area associated with the identity
specified.
C#
public void WriteInt32(string identity, params int[] values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Int32[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteInt32Core(PlcType type, params int[] values)
Parameters
type
PlcType
The PlcInt32Type or PlcInt32ArrayType to write.
values
Int32[]
The array of Int32 data to write.
Writes the Int64 array (in PLC an ARRAY OF LINT) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteInt64(PlcIdentity identity, IEnumerable<long> values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Int64>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int64 (in PLC a LINT) value
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteInt64(PlcIdentity identity, long value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Int64
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int64 array (in PLC an ARRAY OF LINT) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteInt64(PlcIdentity identity, params long[] values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Int64[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int64 array (in PLC an ARRAY OF LINT) values
to the data area associated with the type
specified.
C#
[CLSCompliant(false)] public void WriteInt64(PlcInt64ArrayType type, IEnumerable<long> values)
Parameters
type
PlcInt64ArrayType
The PlcInt64ArrayType which addresses the data area to write.
values
IEnumerable<Int64>
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int64 array (in PLC an ARRAY OF LINT) values
to the data area associated with the type
specified.
C#
[CLSCompliant(false)] public void WriteInt64(PlcInt64ArrayType type, params long[] values)
Parameters
type
PlcInt64ArrayType
The PlcInt64ArrayType which addresses the data area to write.
values
Int64[]
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int64 (in PLC a LINT) value
using the type
specified.
C#
[CLSCompliant(false)] public void WriteInt64(PlcInt64Type type, long value)
Parameters
type
PlcInt64Type
The PlcInt64Type which addresses the data area to write.
value
Int64
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int64 array (in PLC an ARRAY OF LINT) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteInt64(string identity, IEnumerable<long> values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Int64>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int64 (in PLC a LINT) value
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteInt64(string identity, long value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Int64
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Int64 array (in PLC an ARRAY OF LINT) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteInt64(string identity, params long[] values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Int64[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteInt64Core(PlcType type, params long[] values)
Parameters
type
PlcType
The PlcInt64Type or PlcInt64ArrayType to write.
values
Int64[]
The array of Int32 data to write.
Writes the Double (in PLC a LWORD) value
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteLReal(PlcIdentity identity, double value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Double
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double array (in PLC an ARRAY OF LWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteLReal(PlcIdentity identity, params double[] values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Double[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double array (in PLC an ARRAY OF LWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteLReal(PlcIdentity identity, IEnumerable<double> values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Double>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double array (in PLC an ARRAY OF LWORD) values
to the data area associated with the type
specified.
C#
[CLSCompliant(false)] public void WriteLReal(PlcLRealArrayType type, params double[] values)
Parameters
type
PlcLRealArrayType
The PlcLRealArrayType which addresses the data area to write.
values
Double[]
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double array (in PLC an ARRAY OF LWORD) values
to the data area associated with the type
specified.
C#
[CLSCompliant(false)] public void WriteLReal(PlcLRealArrayType type, IEnumerable<double> values)
Parameters
type
PlcLRealArrayType
The PlcLRealArrayType which addresses the data area to write.
values
IEnumerable<Double>
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double (in PLC a LWORD) value
using the type
specified.
C#
[CLSCompliant(false)] public void WriteLReal(PlcLRealType type, double value)
Parameters
type
PlcLRealType
The PlcLRealType which addresses the data area to write.
value
Double
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double (in PLC a LWORD) value
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteLReal(string identity, double value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Double
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double array (in PLC an ARRAY OF LWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteLReal(string identity, params double[] values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Double[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Double array (in PLC an ARRAY OF LWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteLReal(string identity, IEnumerable<double> values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Double>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteLRealCore(PlcType type, params double[] values)
Parameters
type
PlcType
The PlcLRealType or PlcLRealArrayType to write.
values
Double[]
The array of Double data to write.
Writes the data area described by the node
specified.
C#
protected virtual void WriteNodeCore(PlcDataNode node)
Parameters
node
PlcDataNode
The PlcDataNode to write.
When implemented in a derived class, writes the data areas described by the nodes
specified.
C#
protected abstract void WriteNodesCore(IEnumerable<PlcDataNode> nodes)
Parameters
nodes
IEnumerable<PlcDataNode>
The PlcDataNode's to write.
Writes the data areas described by the nodes
specified.
C#
protected void WriteNodesCore(params PlcDataNode[] nodes)
Parameters
nodes
PlcDataNode[]
The PlcDataNode's to write.
Writes the PlcObject specified by T
using the instance
passed.
C#
public void WriteObject<T>(T instance) where T : PlcObject
Parameters
instance
T
The instance of T
to write.
Exceptions
The instance
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Single array (in PLC an ARRAY OF DWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteReal(PlcIdentity identity, IEnumerable<float> values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Single>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Single (in PLC a DWORD) value
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteReal(PlcIdentity identity, float value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Single
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Single array (in PLC an ARRAY OF DWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteReal(PlcIdentity identity, params float[] values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Single[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Single array (in PLC an ARRAY OF DWORD) values
to the data area associated with the type
specified.
C#
[CLSCompliant(false)] public void WriteReal(PlcRealArrayType type, IEnumerable<float> values)
Parameters
type
PlcRealArrayType
The PlcRealArrayType which addresses the data area to write.
values
IEnumerable<Single>
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Single array (in PLC an ARRAY OF DWORD) values
to the data area associated with the type
specified.
C#
[CLSCompliant(false)] public void WriteReal(PlcRealArrayType type, params float[] values)
Parameters
type
PlcRealArrayType
The PlcRealArrayType which addresses the data area to write.
values
Single[]
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Single (in PLC a DWORD) value
using the type
specified.
C#
[CLSCompliant(false)] public void WriteReal(PlcRealType type, float value)
Parameters
type
PlcRealType
The PlcRealType which addresses the data area to write.
value
Single
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Single array (in PLC an ARRAY OF DWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteReal(string identity, IEnumerable<float> values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<Single>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Single (in PLC a DWORD) value
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteReal(string identity, float value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
Single
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the Single array (in PLC an ARRAY OF DWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteReal(string identity, params float[] values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
Single[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteRealCore(PlcType type, params float[] values)
Parameters
type
PlcType
The PlcRealType or PlcRealArrayType to write.
values
Single[]
The array of Single data to write.
Writes the TimeSpan (in PLC a S5TIME) value
to the data area associated with the identity
specified.
C#
public void WriteS5Time(PlcIdentity identity, TimeSpan value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
TimeSpan
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the TimeSpan (in PLC a S5TIME) value
using the type
specified.
C#
public void WriteS5Time(PlcS5TimeType type, TimeSpan value)
Parameters
type
PlcS5TimeType
The PlcS5TimeType which addresses the data area to write.
value
TimeSpan
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the TimeSpan (in PLC a S5TIME) value
to the data area associated with the identity
specified.
C#
public void WriteS5Time(string identity, TimeSpan value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
TimeSpan
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteS5TimeCore(PlcType type, TimeSpan value)
Parameters
type
PlcType
The PlcS5TimeType to write.
value
TimeSpan
The TimeSpan data to write.
Writes the String (in PLC a STRING) value
to the data area associated with the identity
specified.
C#
public void WriteString(PlcIdentity identity, string value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
String
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Byte.
The identity
or value
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the String (in PLC a STRING) value
using the type
specified.
C#
public void WriteString(PlcStringType type, string value)
Parameters
type
PlcStringType
The PlcStringType which addresses the data area to write.
value
String
The value to write to the data area identified by the type
specified.
Exceptions
The type
or value
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the TimeSpan (in PLC a STRING) value
to the data area associated with the identity
specified.
C#
public void WriteString(string identity, string value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
String
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Byte.
The identity
or value
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteStringCore(PlcType type, string value)
Parameters
type
PlcType
The PlcStringType to write.
value
String
The String data to write.
Writes the TimeSpan (in PLC a TIME) value
to the data area associated with the identity
specified.
C#
public void WriteTime(PlcIdentity identity, TimeSpan value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
TimeSpan
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the TimeSpan (in PLC a TIME) value
using the type
specified.
C#
public void WriteTime(PlcTimeType type, TimeSpan value)
Parameters
type
PlcTimeType
The PlcTimeType which addresses the data area to write.
value
TimeSpan
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the TimeSpan (in PLC a TIME) value
to the data area associated with the identity
specified.
C#
public void WriteTime(string identity, TimeSpan value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
TimeSpan
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteTimeCore(PlcType type, TimeSpan value)
Parameters
type
PlcType
The PlcTimeType to write.
value
TimeSpan
The TimeSpan data to write.
Writes the TimeSpan (in PLC a TIME_OF_DAY) value
to the data area associated with the identity
specified.
C#
public void WriteTimeOfDay(PlcIdentity identity, TimeSpan value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
TimeSpan
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the TimeSpan (in PLC a TIME_OF_DAY) value
using the type
specified.
C#
public void WriteTimeOfDay(PlcTimeOfDayType type, TimeSpan value)
Parameters
type
PlcTimeOfDayType
The PlcTimeOfDayType which addresses the data area to write.
value
TimeSpan
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the TimeSpan (in PLC a TIME_OF_DAY) value
to the data area associated with the identity
specified.
C#
public void WriteTimeOfDay(string identity, TimeSpan value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
TimeSpan
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteTimeOfDayCore(PlcType type, TimeSpan value)
Parameters
type
PlcType
The PlcTimeOfDayType to write.
value
TimeSpan
The TimeSpan data to write.
Writes the UInt16 array (in PLC an ARRAY OF WORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt16(PlcIdentity identity, IEnumerable<ushort> values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<UInt16>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt16 (in PLC a WORD) value
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt16(PlcIdentity identity, ushort value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
UInt16
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt16 array (in PLC an ARRAY OF WORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt16(PlcIdentity identity, params ushort[] values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
UInt16[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt16 array (in PLC an ARRAY OF WORD) values
to the data area associated with the type
specified.
C#
[CLSCompliant(false)] public void WriteUInt16(PlcUInt16ArrayType type, IEnumerable<ushort> values)
Parameters
type
PlcUInt16ArrayType
The PlcUInt16ArrayType which addresses the data area to write.
values
IEnumerable<UInt16>
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt16 array (in PLC an ARRAY OF WORD) values
to the data area associated with the type
specified.
C#
[CLSCompliant(false)] public void WriteUInt16(PlcUInt16ArrayType type, params ushort[] values)
Parameters
type
PlcUInt16ArrayType
The PlcUInt16ArrayType which addresses the data area to write.
values
UInt16[]
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt16 (in PLC a WORD) value
using the type
specified.
C#
[CLSCompliant(false)] public void WriteUInt16(PlcUInt16Type type, ushort value)
Parameters
type
PlcUInt16Type
The PlcUInt16Type which addresses the data area to write.
value
UInt16
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt16 array (in PLC an ARRAY OF WORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt16(string identity, IEnumerable<ushort> values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<UInt16>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt16 (in PLC a WORD) value
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt16(string identity, ushort value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
UInt16
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt16 array (in PLC an ARRAY OF WORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt16(string identity, params ushort[] values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
UInt16[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type Word.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
[CLSCompliant(false)] protected virtual void WriteUInt16Core(PlcType type, params ushort[] values)
Parameters
type
PlcType
The PlcUInt16Type or PlcUInt16ArrayType to write.
values
UInt16[]
The array of UInt16 data to write.
Writes the UInt32 array (in PLC an ARRAY OF DWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt32(PlcIdentity identity, IEnumerable<uint> values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<UInt32>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt32 (in PLC a DWORD) value
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt32(PlcIdentity identity, uint value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
UInt32
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt32 array (in PLC an ARRAY OF DWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt32(PlcIdentity identity, params uint[] values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
UInt32[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt32 array (in PLC an ARRAY OF DWORD) values
to the data area associated with the type
specified.
C#
[CLSCompliant(false)] public void WriteUInt32(PlcUInt32ArrayType type, IEnumerable<uint> values)
Parameters
type
PlcUInt32ArrayType
The PlcUInt32ArrayType which addresses the data area to write.
values
IEnumerable<UInt32>
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt32 array (in PLC an ARRAY OF DWORD) values
to the data area associated with the type
specified.
C#
[CLSCompliant(false)] public void WriteUInt32(PlcUInt32ArrayType type, params uint[] values)
Parameters
type
PlcUInt32ArrayType
The PlcUInt32ArrayType which addresses the data area to write.
values
UInt32[]
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt32 (in PLC a DWORD) value
using the type
specified.
C#
[CLSCompliant(false)] public void WriteUInt32(PlcUInt32Type type, uint value)
Parameters
type
PlcUInt32Type
The PlcUInt32Type which addresses the data area to write.
value
UInt32
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt32 array (in PLC an ARRAY OF DWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt32(string identity, IEnumerable<uint> values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<UInt32>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt32 (in PLC a DWORD) value
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt32(string identity, uint value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
UInt32
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt32 array (in PLC an ARRAY OF DWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt32(string identity, params uint[] values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
UInt32[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type DWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
[CLSCompliant(false)] protected virtual void WriteUInt32Core(PlcType type, params uint[] values)
Parameters
type
PlcType
The PlcUInt32Type or PlcUInt32ArrayType to write.
values
UInt32[]
The array of UInt32 data to write.
Writes the UInt64 array (in PLC an ARRAY OF LWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt64(PlcIdentity identity, IEnumerable<ulong> values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<UInt64>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt64 (in PLC a LWORD) value
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt64(PlcIdentity identity, ulong value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
UInt64
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt64 array (in PLC an ARRAY OF LWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt64(PlcIdentity identity, params ulong[] values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
UInt64[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt64 array (in PLC an ARRAY OF LWORD) values
to the data area associated with the type
specified.
C#
[CLSCompliant(false)] public void WriteUInt64(PlcUInt64ArrayType type, IEnumerable<ulong> values)
Parameters
type
PlcUInt64ArrayType
The PlcUInt64ArrayType which addresses the data area to write.
values
IEnumerable<UInt64>
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt64 array (in PLC an ARRAY OF LWORD) values
to the data area associated with the type
specified.
C#
[CLSCompliant(false)] public void WriteUInt64(PlcUInt64ArrayType type, params ulong[] values)
Parameters
type
PlcUInt64ArrayType
The PlcUInt64ArrayType which addresses the data area to write.
values
UInt64[]
The values to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt64 (in PLC a LWORD) value
using the type
specified.
C#
[CLSCompliant(false)] public void WriteUInt64(PlcUInt64Type type, ulong value)
Parameters
type
PlcUInt64Type
The PlcUInt64Type which addresses the data area to write.
value
UInt64
The value to write to the data area identified by the type
specified.
Exceptions
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt64 array (in PLC an ARRAY OF LWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt64(string identity, IEnumerable<ulong> values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<UInt64>
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt64 (in PLC a LWORD) value
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt64(string identity, ulong value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
UInt64
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the UInt64 array (in PLC an ARRAY OF LWORD) values
to the data area associated with the identity
specified.
C#
[CLSCompliant(false)] public void WriteUInt64(string identity, params ulong[] values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
UInt64[]
The values to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or does not refer to a PlcType that addresses data of the raw type LWord.
The identity
is a null reference (Nothing in Visual Basic).
The number of values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
[CLSCompliant(false)] protected virtual void WriteUInt64Core(PlcType type, params ulong[] values)
Parameters
type
PlcType
The PlcUInt64Type or PlcUInt64ArrayType to write.
values
UInt64[]
The array of UInt64 data to write.
Writes the specified value
.
C#
public void WriteValue<T>(IPlcValue<T> value)
Parameters
The IPlcValue´1 to write.
Exceptions
The value
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the T
using the type
specified.
C#
public void WriteValue<T>(PlcArrayType type, IEnumerable<T> values)
Parameters
type
PlcArrayType
The PlcArrayType which addresses the data area to write.
values
IEnumerable<T>
The values to write to the data area identified by the type
specified.
Exceptions
The type
specified can not be used to access the framework type specified by T
.
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the T
using the type
specified.
C#
public void WriteValue<T>(PlcArrayType type, params T[] values)
Parameters
type
PlcArrayType
The PlcArrayType which addresses the data area to write.
values
T
The values to write to the data area identified by the type
specified.
Exceptions
The type
specified can not be used to access the framework type specified by T
.
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes an array of the T
which is associated with the identity
specified.
C#
public void WriteValue<T>(PlcIdentity identity, IEnumerable<T> values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<T>
The array to write to the data area identified by the identity
specified.
Exceptions
The metadata specified could not be resolved to a valid PlcArrayType or the identity
does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The number of items in values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the T
which is associated with the identity
specified.
C#
public void WriteValue<T>(PlcIdentity identity, T value)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
T
The value to write to the data area identified by the identity
specified.
Exceptions
The metadata specified could not be resolved to a valid PlcValueType or the identity
does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes an array of the T
which is associated with the identity
specified.
C#
public void WriteValue<T>(PlcIdentity identity, params T[] values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
T
The array to write to the data area identified by the identity
specified.
Exceptions
The metadata specified could not be resolved to a valid PlcArrayType or the identity
does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The number of items in values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the T
using the type
specified.
C#
public void WriteValue<T>(PlcValueType type, T value)
Parameters
type
PlcValueType
The PlcValueType which addresses the data area to write.
value
T
The value to write to the data area identified by the type
specified.
Exceptions
The type
specified can not be used to access the framework type specified by T
.
The type
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes an array of the T
which is associated with the identity
specified.
C#
public void WriteValue<T>(string identity, IEnumerable<T> values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<T>
The array to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or the metadata specified could not be resolved to a valid PlcArrayType or the identity
does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The number of items in values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the T
which is associated with the identity
specified.
C#
public void WriteValue<T>(string identity, T value)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
value
T
The value to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or the metadata specified could not be resolved to a valid PlcValueType or the identity
does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes an array of the T
which is associated with the identity
specified.
C#
public void WriteValue<T>(string identity, params T[] values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
T
The array to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or the metadata specified could not be resolved to a valid PlcArrayType or the identity
does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The number of items in values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data area described by the type
specified.
C#
protected virtual void WriteValueCore<T>(PlcArrayType type, IEnumerable<T> values)
Parameters
type
PlcArrayType
The PlcArrayType to write.
values
IEnumerable<T>
The values data to write.
Writes the data area described by the type
specified.
C#
protected virtual void WriteValueCore<T>(PlcArrayType type, params T[] values)
Parameters
type
PlcArrayType
The PlcArrayType to write.
values
T
The values data to write.
Writes the data area described by the type
specified.
C#
protected virtual void WriteValueCore<T>(PlcValueType type, T value)
Parameters
type
PlcValueType
The PlcValueType to write.
value
T
The value data to write.
Writes the values specified.
C#
public void WriteValues(IEnumerable<IPlcValue> values)
Parameters
values
IEnumerable<IPlcValue>
The IPlcValue objects to write.
Exceptions
The values
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the values specified.
C#
public void WriteValues(params IPlcValue[] values)
Parameters
values
IPlcValue[]
The IPlcValue objects to write.
Exceptions
The values
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the values specified.
C#
public void WriteValues<T>(IEnumerable<IPlcValue<T>> values)
Parameters
values
IEnumerable<IPlcValue>
The IPlcValue´1 objects to write.
Exceptions
The values
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the values specified.
C#
public void WriteValues<T>(params IPlcValue<T>[] values)
Parameters
The IPlcValue´1 objects to write.
Exceptions
The values
or one of its items is a null reference (Nothing in Visual Basic).
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes an array of the T
which is associated with the identity
specified.
C#
public void WriteValues<T>(PlcIdentity identity, IEnumerable<T> values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<T>
The array to write to the data area identified by the identity
specified.
Exceptions
The metadata specified could not be resolved to a valid PlcArrayType or the identity
does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The number of items in values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes an array of the T
which is associated with the identity
specified.
C#
public void WriteValues<T>(PlcIdentity identity, params T[] values)
Parameters
identity
PlcIdentity
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
T
The array to write to the data area identified by the identity
specified.
Exceptions
The metadata specified could not be resolved to a valid PlcArrayType or the identity
does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The number of items in values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes an array of the T
which is associated with the identity
specified.
C#
public void WriteValues<T>(string identity, IEnumerable<T> values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
IEnumerable<T>
The array to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or the metadata specified could not be resolved to a valid PlcArrayType or the identity
does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The number of items in values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes an array of the T
which is associated with the identity
specified.
C#
public void WriteValues<T>(string identity, params T[] values)
Parameters
identity
String
The PlcIdentity that can be either a PlcAddress which addresses the data area to write. Or a PlcName representing the symbolic name of the PlcType (to write) associated with the Device of this connection.
values
T
The array to write to the data area identified by the identity
specified.
Exceptions
The identity
is an empty string or the metadata specified could not be resolved to a valid PlcArrayType or the identity
does not refer to a PlcType that can be used to access the framework type specified by T
.
The identity
is a null reference (Nothing in Visual Basic).
The number of items in values
is outside of the bounds defined by MinLength and MaxLength.
The connection is not in Opened, Connected or Disconnected state and is therefore not ready to use or the connection is in Faulted state and cannot longer be used.
The connection has been disposed of.
Writes the data areas described by the values
specified.
C#
protected virtual void WriteValuesCore(IEnumerable<IPlcValue> values)
Parameters
values
IEnumerable<IPlcValue>
The IPlcValue's to write.
Writes the data area described by the type
specified.
C#
protected virtual void WriteValuesCore<T>(PlcArrayType type, IEnumerable<T> values)
Parameters
type
PlcArrayType
The PlcArrayType to write.
values
IEnumerable<T>
The values data to write.
Writes the data area described by the type
specified.
C#
protected virtual void WriteValuesCore<T>(PlcArrayType type, params T[] values)
Parameters
type
PlcArrayType
The PlcArrayType to write.
values
T
The values data to write.