AdsClient.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 (in TwinCAT.Ads.dll) Version: 6.0.328+39e3229

Syntax

C#

public 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.

Implements

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

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

AdsClient Class

AddDeviceNotificationExAsync Overload

TwinCAT.Ads Namespace

AdsClient.AdsNotificationEx

AdsClient.DeleteDeviceNotificationAsync(UInt32, CancellationToken)

AddDeviceNotificationEx Overload

AddDeviceNotificationExAsync Overload

TryAddDeviceNotificationEx Overload