IAdsNotifications.AddDeviceNotificationExAsync Method (String, NotificationSettings, Object, Type, .Int32., CancellationToken)

Connects a variable to the ADS client asynchronously. The ADS client will be notified by the AdsNotificationEx event.

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

Syntax

C#

Task<ResultHandle> AddDeviceNotificationExAsync(
    string symbolPath,
    NotificationSettings settings,
    Object? userData,
    Type type,
    int[]? args,
    CancellationToken cancel
)

Parameters

symbolPath

Type: System.String
The symbol/instance path of the ADS variable.

settings

Type: TwinCAT.Ads.NotificationSettings
The notification settings.

userData

Type: System.Object
This object can be used to store user specific data (tag data)

type

Type: System.Type
Type of the object stored in the event argument ('AnyType')

args

Type: .System.Int32.
Additional arguments (for 'AnyType')

cancel

Type: System.Threading.CancellationToken
The Cancellation token.

Return Value

Type: Task.ResultHandle.
A task that represents the asynchronous 'AddDeviceNotification' operation. The ResultHandle type parameter contains the created handle (Handle) and the ErrorCode after execution.

Remarks

Because notifications allocate TwinCAT system resources, a complementary call to DeleteDeviceNotificationAsync(UInt32, CancellationToken) should always be called when the notification is not used anymore.

Reference

IAdsNotifications Interface

AddDeviceNotificationExAsync Overload

TwinCAT.Ads Namespace

IAdsNotifications.AdsNotificationEx

IAdsNotifications.DeleteDeviceNotificationAsync(UInt32, CancellationToken)

AddDeviceNotificationEx Overload

AddDeviceNotificationExAsync Overload

TryAddDeviceNotificationEx Overload