Connectivity Software User's Guide and Reference
Match Method (SparkplugEdgeNodeDescriptor)



OpcLabs.EasySparkplug Assembly > OpcLabs.EasySparkplug Namespace > SparkplugEdgeNodeDescriptor Class : Match Method
The Sparkplug group ID.

The value represents a Sparkplug group ID. It must be a string with valid UTF-8 characters except for the reserved characters of '+' (plus), '/' (forward slash), and '#' (number sign).

The value of this parameter cannot be null (Nothing in Visual Basic).

The Sparkplug edge node ID.

The value represents a Sparkplug edge node ID. It must be a string with valid UTF-8 characters except for the reserved characters of '+' (plus), '/' (forward slash), and '#' (number sign).

The value of this parameter cannot be null (Nothing in Visual Basic).

Determines whether the specified group ID and edge node ID match the filter given by this edge node descriptor.
Syntax
'Declaration
 
Public Function Match( _
   ByVal groupId As String, _
   ByVal edgeNodeId As String _
) As Boolean
'Usage
 
Dim instance As SparkplugEdgeNodeDescriptor
Dim groupId As String
Dim edgeNodeId As String
Dim value As Boolean
 
value = instance.Match(groupId, edgeNodeId)
public bool Match( 
   string groupId,
   string edgeNodeId
)
public:
bool Match( 
   String^ groupId,
   String^ edgeNodeId
) 

Parameters

groupId
The Sparkplug group ID.

The value represents a Sparkplug group ID. It must be a string with valid UTF-8 characters except for the reserved characters of '+' (plus), '/' (forward slash), and '#' (number sign).

The value of this parameter cannot be null (Nothing in Visual Basic).

edgeNodeId
The Sparkplug edge node ID.

The value represents a Sparkplug edge node ID. It must be a string with valid UTF-8 characters except for the reserved characters of '+' (plus), '/' (forward slash), and '#' (number sign).

The value of this parameter cannot be null (Nothing in Visual Basic).

Return Value

Returns true if groupId and edgeNodeId match the filter given by this edge node descriptor; returns false otherwise.
Exceptions
ExceptionDescription

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.

Remarks

 

Sparkplug is a trademark of Eclipse Foundation, Inc. "MQTT" is a trademark of the OASIS Open standards consortium. Other related terms are trademarks of their respective owners. Any use of these terms on this site is for descriptive purposes only and does not imply any sponsorship, endorsement or affiliation.

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