IAdsAnyAccess.ReadAnyAsync Method (UInt32, UInt32, Type, .Int32., CancellationToken)

Reads data asynchronously from an ADS device and writes it to an object.

Namespace: TwinCAT.Ads
Assembly: TwinCAT.Ads.Abstractions (in TwinCAT.Ads.Abstractions.dll) Version: 6.0.328+39e3229

Syntax

C#

Task<ResultAnyValue> ReadAnyAsync(
    uint indexGroup,
    uint indexOffset,
    Type type,
    int[]? args,
    CancellationToken cancel
)

Parameters

indexGroup	Type: System.UInt32 Index group of the ADS variable.
indexOffset	Type: System.UInt32 Index offset of the ADS variable.
type	Type: System.Type Type of the object to be read.
args	Type: .System.Int32. Additional arguments.
cancel	Type: System.Threading.CancellationToken The cancellation token.

Return Value

Type: Task.ResultAnyValue.
A task that represents the asynchronous read operation. The ResultAnyValue parameter contains the read value (Value) and the ErrorCode after execution.

Remarks

As object types only primitive types are supported. If the Type of the object to be read is a string type, the first element of the parameter args specifies the number of characters of the string. If the Type of the object to be read is an array type, the number of elements for each dimension has to be specified in the parameter args.

Type of value Parameter	Necessary Arguments (args)
string	args[0]: Number of characters in the string typed as FixedLengthZeroTerminated.
string[]
Array

Reference

IAdsAnyAccess Interface

ReadAnyAsync Overload

TwinCAT.Ads Namespace