QuickOPC User's Guide and Reference
SubscribeTarget(UAClientMapper,Boolean,Object,String,Boolean) Method



OpcLabs.EasyOpcUA Assembly > OpcLabs.EasyOpc.UA.LiveMapping.Extensions Namespace > UAMapperExtension Class > SubscribeTarget Method : SubscribeTarget(UAClientMapper,Boolean,Object,String,Boolean) Method
The mapper object that will perform the operation.
true to subscribe; false to unsubscribe.
The object being targeted.
The operation will be performed only on mappings tagged with this mapping tag.
true to operate on sub-targets (mapped members of the target) recursively; false otherwise.
Executes the "Subscribe" operation on members of given target object.
Syntax
'Declaration
 
<ExtensionAttribute()>
Public Overloads Shared Sub SubscribeTarget( _
   ByVal mapper As UAClientMapper, _
   ByVal active As Boolean, _
   ByVal targetObject As Object, _
   ByVal mappingTag As String, _
   ByVal recurse As Boolean _
) 
'Usage
 
Dim mapper As UAClientMapper
Dim active As Boolean
Dim targetObject As Object
Dim mappingTag As String
Dim recurse As Boolean
 
UAMapperExtension.SubscribeTarget(mapper, active, targetObject, mappingTag, recurse)
[Extension()]
public static void SubscribeTarget( 
   UAClientMapper mapper,
   bool active,
   object targetObject,
   string mappingTag,
   bool recurse
)
[Extension()]
public:
static void SubscribeTarget( 
   UAClientMapper^ mapper,
   bool active,
   Object^ targetObject,
   String^ mappingTag,
   bool recurse
) 

Parameters

mapper
The mapper object that will perform the operation.
active
true to subscribe; false to unsubscribe.
targetObject
The object being targeted.
mappingTag
The operation will be performed only on mappings tagged with this mapping tag.
recurse
true to operate on sub-targets (mapped members of the target) recursively; false otherwise.
Exceptions
ExceptionDescription

One of the arguments provided to a method is not valid.

This is a usage error, i.e. it will never occur (the exception will not be thrown) in a correctly written program. Your code should not catch this exception.

A null reference (Nothing in Visual Basic) is passed to a method that does not accept it as a valid argument.

This is a usage error, i.e. it will never occur (the exception will not be thrown) in a correctly written program. Your code should not catch this exception.

The component is not licensed for the operation requested.
Remarks
The "Subscribe" operation subscribes to or unsubscribes from changes of an OPC-UA attribute. Only mappings of type OpcLabs.EasyOpc.UA.LiveMapping.UAClientDataMapping that include OpcLabs.EasyOpc.UA.LiveMapping.UADataMappingOperations.Subscribe in their OpcLabs.EasyOpc.UA.LiveMapping.UAClientDataMapping.Operations are affected; other mappings are ignored.
Requirements

Target Platforms: .NET Framework: Windows 10 (selected versions), Windows 11 (selected versions), Windows Server 2016, Windows Server 2022; .NET: Linux, macOS, Microsoft Windows

See Also