AdsClient.CreateVariableHandleAsync Method

Determines the Symbol handle by its instance path asynchronously.

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

Syntax

C#

public Task<ResultHandle> CreateVariableHandleAsync(
    string symbolPath,
    CancellationToken cancel
)

Parameters

symbolPath

Type: System.String
SymbolName / InstancePath.

cancel

Type: System.Threading.CancellationToken
The cancellation token.

Return Value

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

Implements

IAdsHandle.CreateVariableHandleAsync(String, CancellationToken)

Remarks

It is a good practice to release all variable handles after use to regain internal resources in the TwinCAT subsystem. The composite method to this CreateVariableHandleAsync(String, CancellationToken) is the DeleteVariableHandleAsync(UInt32, CancellationToken)

Reference

AdsClient Class

TwinCAT.Ads Namespace

AdsClient.DeleteVariableHandleAsync(UInt32, CancellationToken)

AdsClient.TryCreateVariableHandle(String, UInt32.)

AdsClient.CreateVariableHandle(String)